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PREFACE 


Manual Objectives 

This manual provides a quick reference guide to using specific parts of the 
RSX-11M operating system. It describes the commands and procedures for 
operating the most commonly used parts of the system: the utilities, command 
line interpreters, and some other program development tools. 

Intended Audience 

This manual is intended as a quick reference for RSX-11M users who are al¬ 
ready familiar with the system. It assumes you are already familiar with the 
documentation in the manual set for the software you are using. 

Structure of This Document 

This document consists of sections describing each major component of an 
RSX-11M system. They are: 

On-Line Help Files 
Utilities 

• Bad Block Locator Utility (BAD) 

• Backup and Restore Utility (BRU) 

• File Compare Utility (CMP) 

• File Dump Utility (DMP) 

• Disk Save and Compress Utility (DSC) 

• Line Text Editor (EDI) 

• DEC Standard Editor (EDT) 

• File Transfer Program (FLX) 

• Disk Volume Formatter (FMT) 

• Librarian Utility (LBR) 

• Source Language Input Program (SLP) 

• Object Module Patch Utility (PAT) 

• Peripheral Interchange Program (PIP) 

• Queue Manager — Print and Queue Utility (QMG) 

• Task Image File Patch (ZAP) 





Preface 


Command Line Interpreters 

• Monitor Console Routine (MCR) 

• Digital Command Language (DCL) 

System Management Tools 

• Error Logging System 

• Procedure for Halting a Job in a Print Queue 

Programming Tools 

• On-Line Debugging Tool (ODT) 

• Task Builder (TKB) 

Reference Information 

• ASCII Character Set 

• Directive Error Codes 

• Executive Directive Summary in Alphabetical Order by Macro Call 

• I/O Error Codes 

• RADIX-50 Conversion Table 

• Octal/Decimal Conversion Table 

• Standard File Types 

The Mini-Reference also includes blank pages in the back for you to make notes 
on other system information that you use often. The binder is designed so that 
the holes in line printer listings line up with the posts in the binder; therefore, 
you can also include your own listings in the book. 
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ON-LINE HELP FILES 


Extensive help files for the utilities, MCR, DCL, and many other system compo¬ 
nents are available to you at your terminal. 

For help in logging in to the system, type HELP HELLO (from MCR) or HELP 
LOGIN (from DCL). You’ll need an user-ID and password to log in. 

RSX-11M systems have two major command languages or CLIs. These are 
MCR and DCL. Once you log in, your terminal is set to either MCR or DCL. All 
terminals are set to MCR prior to logging in. 

From an MCR terminal, type HELP LIST for information on available help. 
From a logged-on DCL terminal, type HELP for information on available help. 

The general form of the HELP command is: 

>HELP[/cli][/OUT[PUT]:filespec] topic [subtopic[s]] 

>HELP[/qualifier][/OUT[PUT]:filespec] commandname [switch] 

DCL users can also obtain help while entering a command by typing a question 
mark (?) in response to any DCL prompt. Once the help text has been printed 
on the terminal, the prompt returns and you can continue to enter the com¬ 
mand. 

Normally, HELP text is displayed on your screen, but the /OUT[PUT]:filespec 
qualifier permits you to name a file to which the HELP text is to be written from 
a logged on terminal. 

If you do not include a CLI qualifier to the HELP command, the default is the 
name of the CLI to which your terminal* is set. 

Except for /OUT[PUT], each of the following qualifiers has the effect of specify¬ 
ing a file where help can be found. The MCR form of these qualifiers is limited to 
the first three characters. The DCL form includes the entire qualifier name. 

>HELP/LOC[AL] [param[s]] 
or 

>HELP % [param[s]] 

Specifies that the HELP text is in the file HELP.HLP in the default directory on 
the default volume. HELP/LOC and HELP % are the same. 

> HELP/GRO[UP] [param[s]] 

Specifies that the HELP text is in the file HELP.HLP in the directory [current 
group, 1] on the default volume. 

>HELP/CLI:cliname [param[s]] 

Specifies that the HELP text begins in the file LB:[l,2]cli_name.HLP. This 

qualifier is for installations with alternate CLIs for which HELP is provided. 
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On-Line HELP Files 


>HELP/MCR [param[s]] 

Specifies that the HELP text begins in the file LB:[1,2]MCR.HLP. This is the 
default for terminals set to MCR. 

>HELP/DCL [param[s]l 

Specifies that the HELP text begins in the file LB:[1,2]DCL.HLP. This is the 
default for terminals set to DCL. 

>HELP/FIL[E]:filespec [param[s]] 

Specifies any file where HELP text is located. If you do not give a complete file 
specification, the defaults are LB:[l,2]filename.HLP. 

>HELP/xxx [param[s]J 

Specifies that the HELP text is located in the file LB:[l,2]xxx.HLP, where xxx is 
a 3-character file name. 
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BAD COMMAND SUMMARY 


Command lines for the Bad Block Locator (BAD) use the following format: 
BAD ddn:[/switchl.../switchn] 

In this command line, dd is the abbreviation for the volume on which BAD is 
being run and n is the unit number of the volume. 

BAD switches are: 

ALLOCATE BAD ddn:/ALO|:volumelabel| 

Prompts you for blocks to be allocated to BADBLK.SYS and to be entered 
in the bad block descriptor file. 

CSR ADDRESS BAD ddn:/CSR=nnnnn 

Specifies the CSR address of a device that is not in a standard location 
(stand-alone version of BAD only). 

LIST BAD ddn:/LI 

Lists bad blocks as they are located. 

MANUAL BAD ddn:/MAN 

Allows you to enter bad blocks, which are then included in the bad block 
descriptor file. 

NOWRITECHECK BAD ddn:/NOWCHK 

Negates the effect of /WCHK (see below). 

OVERRIDE BAD ddn:/OVR 

Creates the bad block descriptor file on a last-track device. 

PATTERN BAD ddn:/PAT=m:n 

Specifies the double-word data pattern used to locate bad blocks. 

RETRY BAD ddn:/RETRY 

Recovers soft errors. 

UPDATE BAD ddn:/UPD 

Reads the bad block descriptor file and prompts for your entries. 
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BAD Command Summary 


VECTOR BAD ddn:/VEC=nnn 

Specifies the interrupt vector address of a device that is not in a standard 
location (stand-alone version of BAD only). 

WRITECHECK BAD ddn:/WCHK 

Causes a write-check operation to take place after each write operation 
(stand-alone version of BAD only). The switch is not valid for DT:-, DX:-, 
or DY:-type devices. 
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BRU COMMAND SUMMARY 


Command lines for the Backup and Restore utility (BRU) use the following 
format: 

[/qualifiers] indev 1:,... [filespec,... ] outdevl:,... [filespec,... ] 

In this command line, qualifier(s) are any of the command qualifiers listed 
below, indevices are the physical device or devices from which data is trans¬ 
ferred, filespec is the particular file or category of file to be backed up or re¬ 
stored, and outdevice(s) are the output devices to which data is being trans¬ 
ferred. 

BRU qualifiers are: 

/APPEND 

Appends new backup data to a tape, or to a disk if you are using the 
/IMAGE qualifier. 

BACKUP_SET: name 

Specifies the name of the backup set to be placed on tape or disk. 

/BAD: MANUAL 

AUTOMATIC 

OVERRIDE 

Enters the locations of bad blocks on volumes. The default is /BAD: AUTO¬ 
MATIC. 

/BUFFERS:number 

Specifies the default number of directory File Control Blocks (FCBs) kept 
by the ACP for the volume. 

/COMPARE 

Compares the data on the output volume to the data on the input volume 
and reports any differences. 

/CREATED: BEFORE:dd-mmm-yy 

BEFORE:hh:mm:ss 
BEFORE(dd-mmm-yy hh:mm:ss) 

AFTER:dd-mmm-yy 
AFTER: hh: mm :ss 
AFTER:(dd-mmm-yy hh:mm:ss) 

Directs BRU to process files created before or after a specified date and/or 
time. 
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BRU Command Summary 


/DENSITY:number 

Specifies the data density at which BRU writes to tape. 

/DIRECTORY 

Displays information (such as backup set names, file names, or volume 
number of a tape or disk) for a specified tape or disk volume. 

/DISPLAY 

Displays at your terminal the UFD and file name of each file being backed 
up. 


/ERRORS:number 

Specifies the number of nonfatal I/O errors BRU tolerates on tape reads 
during a restore operation before automatically terminating execution. The 
default is 25(decimal) errors. 

/EXCLUDE 

Excludes selectively from a backup or restore operation all files specified 
on the command line. 

/EXTENDrnumber 

Specifies the number of blocks by which a file is extended when that file 
has exhausted its allocated space. 

/HEADERS:number 

Specifies the number of file headers to allocate initially to the index file. 

/IMAGE:SAVE 

RESTORE 

Specifies that you want to do a multiple disk-to-disk backup or restore 
operation. Use the SAVE option for backup operations. Use the RESTORE 
option for restore operations. 

/INITIALIZE 

Directs BRU to initialize the output disk before proceeding with the opera¬ 
tion. 

/INVOLUME:name 

Specifies the volume label of the input disk. 
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BRU Command Summary 


/LENGTH:number 

Specifies the length of the output tape in decimal feet. 

/MAXIMUMinumber 

Specifies the maximum number of files that can be placed on a volume as 
determined by the number of file headers in the volume’s index file. 

/MOUNTED 

Allows you to back up files from a disk that is mounted with the MCR or 
DCL MOUNT commands as a Files-11 volume. 

/NEW_VERSION 

Directs BRU to resolve conflicts resulting from files with identical file 
specifications by creating a new version of the file. 

/NOINITIALIZE 

Specifies that you do not want to initialize the output disk because it is 
already in Files-11 format. 

/NOPRESERVE 

Specifies that you do not want to preserve file identifiers. 

/NOSUPERSEDE 

Specifies that where files on the input and output volumes have identical 
filespecs, the input files will not be transferred and the output files will not 
be superseded. The default is /NOSUPERSEDE. 

/OUTVOLUME:name 

Specifies the volume label of the output disk. The label can be up to 12(10) 
characters long. 

/POSITION: BEGINNING 

MIDDLE 
END 

BLOCK:number 

Specifies the location of the index file on the output disk volume. 
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BRU Command Summary 


/PROTECTION: SYSTEMivalue 

OWNERrvalue 
GROUP:value 
WORLD.value 

Specifies the default protection status for all files created on the output 
volume being initialized. 

/REVISED: BEFORE:dd-mmm-yy 

BEFORE:hh:mm:ss 
BEFORE:(dd-mmm-yy hh:mm:ss) 

AFTER :dd-mmm-yy 
AFTER:hh:mm:ss 
AFTER:(dd-mmm-yy hh:mm:ss) 

Directs BRU to process files revised before or after a specified date and/or 
time. 

/REWIND 

Rewinds the first tape of a tape set before performing the operation. 

/SUPERSEDE 

Resolves file specification conflicts by deleting the old file on the output 
volume and replacing it with the file from the input volume. (The default is 
/NOSUPERSEDE.) 

/TAPE_LABEL: label 

Specifies a 6-character ANSI volume identifier for identifying the tape 
volume. 


/UFD 


Directs BRU to create UFDs (if they do not already exist) on a mounted 
output volume, then copy into them the files from the same UFDs on the 
input volume. 

/VERIFY 

Copies data from the input volume to the output volume, compares the 
volumes, and reports any differences. 

/WINDOWS:number 

Specifies for the output disk the default number of mapping pointers allo¬ 
cated for file windows. The default number is the same as that for the 
input disk. 
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CMP COMMAND SUMMARY 


Command lines for the File Compare Utility (CMP) use the following format: 
CMP [outfile[/sw...=]infilel,infile2 

In this command line, outfile is the file specification for the output file that 
contains the comparison, sw is one or more of the CMP switches described 
below, and infiles are the two files being compared. 

If you do not specify an output file, CMP output defaults to TI: and is displayed 
on your terminal. If you specify the equals (=) sign, but no output file, CMP 
displays only the total number of differences it finds in the input files. 

CMP switches, which always modify the output file specification or the default 
output file specification, are: 

BLANK LINES [outfile] /[-]BL=infile1,infile2 

Specifies that blank lines in both files be included in compare processing. 
If specified in the form /-BL, blank lines are not included in compare 
processing. /-BL is the default switch. 

CHANGE BARS [outfile] /[-]CB=infile1,lnfile2 

Specifies that CMP list infile2 with change bars, in the form of exclama¬ 
tion marks (!), to denote each line that does not have a corresponding line 
in infilel. /-CB is the default switch. 

You can change the change bar character from the exclamation mark to 
any character you wish by means of the /VB switch, described below. 

When a section of lines in infilel has been deleted in infile2 (the output 
listing file), the first line after the deleted lines is marked. 

COMMENTS [outfile] / [-]CO=infile1 ,infile2 

Specifies that CMP include comments (that is, text preceded by a semico¬ 
lon) in compare processing. /CO is the default switch. 

DIFFERENCES [outfile] / [-]DI=lnfile1 ,infile2 

Specifies that CMP list the differences between the two files (rather than 
marking the lines in infile2). /DI is the default switch. 

/CB and /DI are mutually exclusive switches. If both are specified, /CB 
overrides /DI. 
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CMP Command Summary 


FORM-FEED |outfile |/\-]FF infilel ,infile2 

Specifies that CMP include records consisting of a single form-feed charac¬ 
ter in compare processing. /-FF is the default switch. 

LINES |outfile| / Lhninfilel ,infile2 

Specifies that a number (n) of lines must be identical before CMP recog¬ 
nizes a match. If you do not specify this switch, CMP searches for three 
identical lines to match (/LI:3). 

When it encounters a match, CMP prints all the preceding nonmatching 
lines, along with the first line of the matched sequence of lines, to help you 
find the location in the code where the match occurred. 

LINE NUMBER foutfile|/LN infilel,Infile2 

Specifies that lines in the output file be preceded by their line number. 
Line numbers are incremented by one for each record read, including blank 
lines. /LN is the default switch. If you specify /SL (below), /LN is unneces¬ 
sary. 

MERGE BLANKS [outfile|/|-|MB=infile1 ,infile2 

Specifies that CMP include all blank and tab characters in a line in com¬ 
pare processing. If you specify /-MB, CMP interprets any sequence of 
blank and/or tab characters as a single blank character in compare process¬ 
ing. However, all spaces and tabs are printed in the output listing. /MB is 
the default switch. 

SLP FILE outfile/SL[:aul infilel,Infile2 

Directs CMP to generate an output file suitable for use as SLP command 
input. When you specify /SL, CMP generates the SLP command input 
necessary to make infilel identical to infile2. If a 1- to 8-character alphanu¬ 
meric symbol is included (:au), an audit trail is specified for SLP input. 

SPOOL outfile / HSP[:nl=lnfile1 ,lnfile2 

Specifies that the output file be spooled on the line printer. You can op¬ 
tionally specify the number (in octal or decimal) of files to be spooled. /-SP 
is the default switch. 

This switch applies only if you have the print spooler task (RSX-11M) or 
the Queue Manager (RSX-11M/M-PLUS) installed. 
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CMP Command Summary 


TRAILING BLANKS |outfile|/f-lTB=infile1 ,infile2 

Specifies that CMP include all trailing blanks on a line in compare pro¬ 
cessing. If you specify /-TB, CMP ignores all blanks following the last 
nonblank character on a line. When you specify /-CO and /-TB together, 
blanks that precede a semicolon (;) are considered trailing blanks and are 
ignored. /TB is the default switch. 

VERTICAL BAR outfile/VB:nnn=infile1 ,infile2 

Specifies an octal character code for use as a change bar. You use this 
switch with the /CB switch. The value nnn specifies the octal character 
code. For example, you can specify /VB:174 for a vertical bar (if your 
printer is capable of printing the vertical bar character). /VB:041 (for the 
exclamation mark) is the default switch. 
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DMPCOMMAND SUMMARY 


Command lines for the file dump utility (DMP) use the following format: 
[outfile][/switch(es)]=inspec[/switch(es)l 

In this command line outfile specifies the output file dump, switch(es) is one or 
more of the DMP switches described below, and inspec specifies the input device 
and file or input device only. 

The command line elements take the following defaults: 

ASCII outfile=infile/AS 

Specifies that data be dumped one byte at a time in ASCII mode. 

BASE ADDRESS outfile/BA:n:m=infile 

Specifies a 2-word base block address. 

BLOCK outfile=infile/BL:n:m 

Specifies the first and last logical blocks to be dumped. 

BYTE outfile=infile/BY 

Specifies that data be dumped in octal byte format. 

DECIMAL outfile/DC=infile 

Specifies that data be dumped in decimal word format. 

DENSITY outfile=infile/DENS:n 

Specifies density of an input magnetic tape when DMP is in device mode 
only. Values for n can be 800, 1600, or 6250. 

FILE ID outfile=infile/FI:filenumber:sequencenumber 

Specifies the input file with its file-ID instead of its name (File Mode only). 

HEADER outfile=infile/HD:F 
outfile infile/HD:U 

Includes the file header in the data dumped. “F”, the default, specifies a 
formatted Files-11 dump for the header. “U” specifies an unformatted 
octal dump. 

HEADER FILES-11 outfile=lnfile/HF 

Specifies the format for data blocks that have the Files-11 header struc¬ 
ture. Other blocks are dumped as unformatted octal. 
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DMP Command Summary 


HEXIDECIMAL outfile/HX infile 

Specifies that data be dumped in hexadecimal byte format. 

IDENTIFICATION /ID 

Causes the current version of DMP to be displayed or printed. 

LOGICAL BLOCK outfile infile/LB 

Requests the starting (logical) block number and a contiguous or noncon¬ 
tiguous indication for the file to be displayed. 

LOWERCASE outfile=infile/LC 

Specifies that the data should be dumped in lowercase characters. This 
switch is valid only if the output device supports lowercase characters. 

LONG WORD outfile=infile/LW 

Specifies that data be dumped in hexadecimal double-word format. 

MEMORY outfile/MDrfnHnfile 

Controls line number sequencing during a memory image dump. 

OCTAL outfile=infile/OCT 

Specifies that the data should be dumped in octal format. If no DMP 
format switches are included, the default is octal format. 

RECORD outfile=infile/RC 

Dumps one record at a time in the specified format. 

REWIND outfile/RW-infile|/RWl 

Issues a rewind command to the tape driver before referencing a specified 
tape. You can use the /RW switch at any time to reposition a tape at 
beginning-of-tape (BOT). 

RADIX-50 outfile=infile/R5 

Dumps in Radix-50 word format. 

SPACE BLOCKS outfile infile/SB:[-]n 

Specifies the number of blocks DMP spaces forward (n) or backwards (-n) 
on a tape. 
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DMP Command Summary 


SPACE FILES outfile=infile/SF:|-]n 

Specifies the number of end-of-file (EOF) marks DMP spaces forward (n) 
or backward (-n) on a tape. 

SPOOL outfile/SP infile 

Spools the dump file (the output file) to the line printer. 

WORD outfile=infile/WD 

Specifies that data be dumped in hexadecimal word format. 
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DSC COMMAND SUMMARY 


Command lines for the Disk Save and Compress utility (DSC) use the following 
format: 

DSC outdevls]: [label] [/switch[es]]=indev[s]: [label] [/switch] 

In this command line, outdev[s] is the physical volume or volumes to which data 
is copied, label identifies the volume id of the output or input device, switches] 
are the command switches described below, and indev[s] is the physical volume 
or volumes from which data is copied. 

DSC switches are: 

APPEND outdev:/AP=indev 

Appends a DSC file to the first volume of a magnetic tape set that already 
contains a DSC file. 

BAD MAN 

NOAUTO 

outdev:/BAD=MAN:NOAUTO=indev 

OVR 

MAN:OVR 

Allows manual entry of bad block locations; can supplement, override, or 
ignore the disk’s own bad block file. 

BLOCKS outdev:/BL=n=indev 

Sets the number of 256-word blocks DSC can include in each of its two 
buffers. 

COMPARE outdev:/CMP=indev 

Compares input and output volumes for differences. 

CSR outdev:/CSR nnnn indev 

Specifies control status addresses for a specific Status Control Block 
(SCB). /CSR is valid only with the stand-alone version of DSC. 

DENSITY outdev:/DENS=nnnn=indev 

Overrides the DSC default storage density for magnetic tapes of 800 bpi. 
The first form of the switch creates magnetic tapes at 1600 bpi density. The 
second form (the split density switch) creates magnetic tapes with volume 
header information at 800 bpi and the rest of the tape at 1600 bpi. 
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DSC Command Summary 


REWIND outdev:/RW=indev 

Rewinds all volumes in a magnetic tape set before execution of the current 
command line. 

TM02 outdev/TM02 nn Indev 

Specifies the physical unit number of the formatter on the RH11/RH70 
controller (stand-alone version of DSC only). 

UNIT outdev/UNIT=nn=indev 

Specifies the physical unit that will be referenced by the indicated Unit 
Control Block (UCB). The /UNIT switch is valid only with the stand-alone 
version of DSC. 

VERIFY outdev/VE=indev 

Copies data from the input volume and compares it with the output vol¬ 
ume following the data transfer. 

VECTOR outdev/VEC=nnn=indev 

Specifies the vector address for a specific Status Control Block (SCB). The 
/VEC switch is valid only with the stand-alone version of DSC. 
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LINE TEXT EDITOR (EDI) COMMANDS 


In this section, the following conventions are used: 

The asterisk (*) can be used in place of any number in an EDI command. It 
is read as 32,767. 

An ellipsis (...) can be used in many search strings to identify characters 
between the first and last characters of the string. 

EDI allows the use of abbreviations in commands. 

ADD A string 

Adds the text in the string to the end of the current line. 

ADD AND PRINT AP string 

Adds the text in the string to the end of the current line and displays the 
entire line on the terminal. 

ALTMODE fATrl 

or 

escape m 

In Line Mode, prints previous line and makes it the new current line. In 
Block Mode, exits from input mode. 

BEGIN B 

Sets the current line to the line preceding the top line in the file or block 
buffer. In Line Mode, creates a copy of the file. 

BLOCK ON/OFF BL 

Changes from the EDI Block Mode to Line Mode or from Line Mode to 
Block Mode to access text. 

BOTTOM BO 

Moves the line pointer to the bottom of the current block (in Block Mode) 
or to the bottom of the file (in Line Mode). 

CHANGE [ nlC/strlngl /string2[/] 

Replaces string 1 with string 2 in the current line n times. 
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Line Text Editor (EDI) Commands 


CLOSE CL (filespecl 

Transfers the remaining lines in the block buffer and input file to the 
output file, and closes all files. Renames output files to filespec. 

CLOSE AND DELETE CDL [filespecl 

Transfers the remaining lines in the block buffer and the input file to the 
output file, closes the output file, and deletes the input file. 

CLOSE SECONDARY CLOSES 

Closes the secondary input file. 

CONCATENATION CHARACTER CC [letter] 

Changes the concatenation character used to separate EDI commands on 
one line to the character specified. (The default concatenation character is 
&.) 

CTRL/Z Etrl/z) 

Closes all open files and terminates the editing session. 

DELETE D [n] or D [-n] 

Deletes the current line and the next n-1 lines if n is a positive number. 
Deletes n lines preceding the current line, but not the current line, if n is a 
negative number. Negative numbers can only be used in Block Mode. 

DELETE AND PRINT DP [n] or DP [-n] 

Deletes lines specified and prints the new current line. 

END E 

Sets the last line in a file or block buffer as the current line. 

ERASE ERASE [n] 

Erases the current line in Line Mode. Erases the current block buffer and 
the next n-1 blocks in Block Mode. 

ESCAPE m 

or 

ALTMODE @LT) 

In Line Mode prints the previous line and makes it the new current line. In 
Block Mode, exits from Input Mode. 
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EXIT EX [filespec] 

Transfers the remaining lines in the block buffer and input file to the 
output file. Closes files, renames the output file if specified, and terminates 
the editing session. 

EXIT AND DELETE ED [filespecl 

Transfers the remaining lines in the block buffer and input file to the 
output file, closes files, and renames the output file if specified. Deletes the 
input file and terminates the editing session. 

FILE FIL filespec 

Transfers lines from the input file to both the output file and the specified 
file until a form feed or end-of-file is encountered. The original file remains 
intact. This command is only used in Line Mode. 

FIND ]n]F string 

Finds the line in the current block starting with string, or the nth line, 
starting with string. A string must begin in the first column of the line to be 
a match. 

FORM FEED FF 

Inserts a form feed into the block buffer. 

INSERT IN [string] 

Enters the specified string immediately following the current line. If no 
string is specified, EDI enters Input Mode. 

KILL KILL 

Closes the input and output files and deletes the output file. 

LINE CHANGE [nlLC/string1/string2[/] 

Changes all occurrences of string 1 in the current line (and n-1 lines) to 
string 2. 

LIST ON TERMINAL LI 

Displays on the terminal all lines remaining in the block buffer or input 
file, starting with the current line. 

LIST ON PSEUDO SEVICE LP 

Displays on the Console Listing Device, CL:, lines remaining in the block 
buffer or input file, starting with the current line. 
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LOCATE |n|L string 

Locates the nth or next occurrence of the specified string. In Block Mode, 
the search stops at the end of the current block. 

MACRO MACRO x definition 

Defines the macro number x for the EDI commands in the definition. The 
value x can be 1, 2, or 3. 

MACRO CALL MC[;nl 

Retrieves a macro definition stored in the file MCALL;n. 

MACRO EXECUTE |n|Mx |a| 

Executes macro x n times, while passing numeric argument a to it. The 
value x can be 1, 2, or 3. 

MACRO IMMEDIATE [n] <definition> 

Defines and executes a macro n times. Stores it as macro number 1. 

NEXT N [n] or N [-n| 

Establishes a new current line n lines away from the current line. 

NEXT AND PRINT NP|nl or NP[-nl 

Establishes a new current line and displays it on the terminal. 

OPEN SECONDARY OP filespec 

Opens the specified secondary input file. 

OUTPUT ON/OFF OU ON or OU OFF 

Continues or discontinues a file transfer to output file in Line Mode. 

OVERLAY O [n| 

Deletes n lines, enters Input Mode, and inserts new lines, as typed, in place 
of the deleted lines. 

PAGE PAG n or -n 

Enters Block Mode. Reads page n into current block buffer. If n is less than 
the current page, EDI goes to the top of the file first. Pages are set by form 
feed characters. 
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PAGE FIND [n|PF string 

Searches successive block buffers for the nth occurrence of the string. The 
string must begin in the first column of the line. 

PAGE LOCATE (n)PL string 

Searches successive blocks for the nth occurrence of the string. The string 
can begin anywhere on the line. 

PASTE PA/strlng1/strlng2f/l 

Searches for all remaining lines in the input file or block buffer that con¬ 
tain string 1 and replaces them with string 2. 

PRINT P [n| 

Displays the current line and the next n-1 lines on the terminal. The last 
line printed becomes the current line. 

READ REA n 

Reads the next n blocks of text into the block buffer. If the buffer already 
contains text, the new text is appended to it. 

RENEW REN [n] 

Writes the current block to an output file and reads a new block n from an 
input file (Block Mode only). 

RETURN m 

Displays the next line on the terminal and makes it the current line. Exits 
from Input Mode if it is entered as the first character of a line. 

RETYPE R string 

Replaces the current line with the specified string, or deletes the current 
line if no string is specified. 

SAVE SA fn] |fllespecl 

Saves the current line and the next n-1 lines in the specified file. If no file 
is specified, saves the lines in SAVE.TMP. 

SEARCH AND CHANGE SC/string1/string2[/l 

Locates string 1 and replaces it with string 2. 
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SELECT PRIMARY SP 

Reestablishes the primary file as the input file. 

SELECT SECONDARY SS 

Selects the secondary file that will be an input file. 

SIZE SIZE n 

Specifies the maximum number of lines that can be read into a block 
buffer. 

TAB TA ON or TA OFF 

Turns automatic tabbing on or off. 

TOP T[OP] 

Sets the current line to the line preceding the top line in the file or block 
buffer. In Line Mode, creates a copy of the file. 

TOP OF FILE TOF 

Returns to the top of the input file in Block Mode and saves all of the 
previously edited pages. Reads in a new block after writing the output file. 
This command creates a new version of the file each time it is executed in 
Line Mode. 

TYPE TY | n] 

Displays the next n lines on the terminal. This command is identical to the 
PRINT command in Line Mode. However, in Block Mode, the line pointer 
remains at the current line unless EDI reached the end of a block. 

UNSAVE UNS [filespec] 

Inserts all lines from the specified file following the current line. If no file 
name is used, EDI uses SAVE.TMP. 

UPPER CASE UC ON or UC OFF 

Enables or disables conversion of lowercase letters to uppercase letters 
when they are entered at a terminal. 

VERIFY VON or V OFF 

Selects whether the operation of the LOCATE and CHANGE commands 
will be verified (printed on the terminal) after the line is located or 
changed. 
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WRITE W 

Writes the contents of the block buffer to the output file and erases the 
block buffer. 
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DIGITAL STANDARD EDITOR (EDT) COMMANDS 


EDT lets you edit text in line mode and character mode, using the keypad or 
nokeypad functions. 

LINE MODE COMMANDS 

You can tell EDT is in line mode when you receive an asterisk prompt ( * ). You 
can then edit the text on a line-by-line basis. Enter a Ctrl/Z) to exit from EDT. 
The following commands work from EDT line mode: 

CHANGE C [range| 

Starts either keypad or nokeypad character editing, depending upon the 
terminal type. EDT defaults to keypad character editing for VT52 and 
VT100 terminals and nokeypad editing for all other terminals. EDT puts 
the cursor ahead of the location you specify as range. 

Entering a Ctrl/z) returns you to line mode. 

CLEAR CL textbuffer 

Deletes the contents of a text buffer, but does not delete the buffer itself. 

COPY CO [range-11 TO [range-2][/qualifier(s)] 

Copies text from range-1 to the location in front of the line you specify in 
range-2. EDT can copy from one buffer to another or from one place to 
another within a text buffer. 

Qualifiers: 

QUERY Verifies each line to be inserted. 

DUPLICATE Inserts the range of text more than once. 

DEFINE KEY DEF K|[GOLDlfnumber! CONTROL letter)! GOLD character) 
AS string 

Redefines keypad keys in terms of nokeypad commands. The following 
table describes the command format: 


number 


Braces )) 


OR 


Brackets [] 


You must choose one of the options. 

Separates choices. 

You can use GOLD to specify the alternate func¬ 
tion of a keypad or control key. 

Number of the keypad key. 
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Control letter 


Enter CONTROL and a character from A to Z. 
The GOLD keypad key. 


GOLD 


GOLD character Enter GOLD and any keypad character except 
0-9, !, %, and 


string' 


One or more nokeypad commands used to rede¬ 
fine the key. 


DEFINE MACRO DEF M macroname 

Assigns a name to a sequence of editor commands stored in the file macro¬ 
name. 

DELETE D |range||/qualifier] 

Deletes the lines specified and displays a message stating the number of 
lines deleted. When you do not specify a range, deletes the current line. 

Qualifier: 

QUERY Verifies each line to be deleted 

EXIT EX [filespec](/qualifier(s)] 

Ends an editing session and moves the main text buffer to the output file 
specified. You can define the name of the output file in the command line 
that invokes EDT or in the EXIT command. 

Qualifiers: 

SEQ[UENCE][:initial[:increment]] Assigns integer line numbers before 


the text transfer and places them in a 
fixed field in the file. You define the 
initial number and the increment be¬ 
tween numbers. 


SA[VE] 


Saves the journal file created during 
the editing session. 


FIND F range 

Locates the line or lines specified by range. 


HELP H |topic| subtopic 1| 

Displays information on requested topics or subtopics. 
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INCLUDE INC filespec |range| 

Copies disk files into text buffers. Filespec is the name of the File you want 
to copy. EDT copies the file to the current text buffer in front of the first 
line of the range. 

INSERT I frange][;line to be inserted] 

Inserts text into a buffer. When you specify a range, EDT inserts the text 
before the first line of the range. If you do not specify a range, EDT inserts 
the text before the current line. 

MOVE M [range-1] TO [range* n2][/qualifier] 

Moves the lines in range-1 to the location preceding range-2. Deletes the 
text from range-1. 

Qualifier: 

QUERY: EDT prompts you to verify each line of range-1 to be moved. 

null (Implied TYPE) [range]© 

Displays the next line of text. You can specify a range of text to be dis¬ 
played. However, the REST, WHOLE, BEGIN, END, LAST, and ALL 
range specifications must be preceded by a percent sign (%). 

PRINT P filespec!range| 

Copies text from a text buffer into a file. Range selects a portion of the 
buffer to be copied. Without a range, the default is the current text buffer. 

QUIT QUIT[/qualifier] 

Ends the current editing session without saving the main text buffer. 

Qualifier: 

SAVE Saves the contents of the journal file under the name specified in 
the command line to invoke EDT. 

REPLACE R [range]| ;line to be inserted! 

Deletes lines specified in range and inserts new text. EDT inserts the new 
text at the first line in the range specification. Without a range, EDT 
deletes the current line and inserts the new text in its place. 
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RESEQUENCE RES [rangefl/qualifier] 

Assigns new line numbers to the contents of a buffer or the range of lines 
specified. Without a range, EDT resequences all lines in the current text 
buffer. 

Qualifier: 


SEQ[UENCE][:initial[:increment]] Sets the first line resequenced to the 

initial value and increments succeed¬ 
ing numbers by the increment speci¬ 
fied. 


SET SET parameter 

Control the operating characteristics of EDT. 

Parameters: 

CASE {UPPER ! LOWER ! NONE) 

EDT flags upper- or lowercase characters with a preceding apos¬ 
trophe. The default is NONE, which does not flag any characters. 

CURSOR top:bottom 

Sets the number of lines over which the cursor moves on the display. 
Top is the number of lines for the upper limit and bottom is the 
number of lines for the lower limit 

ENTITY {WORD ! SENTENCE I PARAGRAPH ! PAGE) string' 

Sets user-definable entities for character editing. 

KEYPAD 

Allows the keypad to control the character-editing operation. 

LINES number 

Sets the number of lines that EDT displays on the terminal during 
character editing. 

MODE {LINE I CHANGE) 

Used in a start-up command file to control the editing mode entered 
at the end of the initialization. 

[NO]NUMBERS 

Determines whether EDT displays line numbers in line editing. De¬ 
fault: NUMBERS 

(NO]QUIET 

Controls the ringing of the terminal bell when an error occurs in 
change mode editing. Default: NOQUIET 


30 






DIGITAL Standard Editor (EDT) Commands 


SCREEN width 

Controls the maximum width of the line EDT displays. Default: 80 
characters 

SEARCH (EXACT! GENERAL) 

EDT searches for exact comparisons of case or ignores case in 
searches. Default: GENERAL 

(BOUNDED! UNBOUNDED) 

EDT stops searching at the next page entity marker. Default: UN¬ 
BOUNDED 

(BEGIN! END) 

EDT leaves the cursor at the end of the string when it is found. If the 
string is not found, the cursor does not move. Default: BEGIN 

(TAB n! NOTAB) 

Sets the number of spaces for the first tab stop in keypad editing. 
Remaining tabs are unchanged. Default: 8 

TERMINAL (HCPY ! VT52 ! VT100) 

Determines the type of terminal in use. EDT gets the terminal type 
from the operating system and this command overrides that setting. 

[NO]TRUNCATE 

Ends display of a line at the value of SET SCREEN. Default: TRUN¬ 
CATE 

[NO]VERIFY 

Enables or disables display of commands from command files and 
macro commands. Default: NOVERIFY 

[NOJWRAP n 

Sets or eliminates a line length limit of n character positions. Default: 
NOWRAP 

SHOW SHOW parameter 

Displays the operating characteristics of EDT. 

Parameters: 

BUFFER 

Lists the buffers in use during the current editing session and the 
number of lines of text in each. 

CASE 

Shows the current case setting. 

CURSOR 

Shows the current cursor range. 
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ENTITY (WORD ! SENTENCE ! PARAGRAPH ! PAGE} 

Shows the current setting for the user-definable entity specified. 

KEY |[GOLD]fnumber: CONTROL letter}! GOLD character} 

Shows the definition of the specified key in change mode. 

SCREEN 

Shows the current setting for screen width. 

SUBSTITUTE S/string-1 /string-2/[rangelf/qualifier(s)] 

Replaces occurrences of string-1 with string-2 within the range specified. 
Without a range, EDT replaces the next occurrence of string-1 with 
string-2. EDT returns to the first line in the specified range at the end of 
the substitution. 

Qualifiers: 

B[RIEF][:n] EDT displays the first n characters of the line containing 
string-1. The default for n is 10. 

Q[UERY] EDT prompts you to verify each line of range-1 to be moved. 

NOT[TYPE] EDT does not display the lines on which it makes substitu¬ 
tions. 

SUBSTITUTE NEXT \S] N[/string-1/string-21 

EDT searches for the next occurrence of string-1 from the current location 
forward. The line on which the substitution is made becomes the current 
line. 

If you do not specify string-1 or string-2, EDT uses the strings specified in 
the last SUBSTITUTE command. 

TYPE T | range |(/qualifier(s)] 

Displays the specified range of lines, or all the lines in the current text 
buffer. 

Qualifiers: 

B[RIEF][:n] EDT displays the first n characters of the selected lines. The 
default for n is 10. 

S[TAY] EDT does not change the cursor position. 
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WRITE WR filespec | range||/qualifier| 

Copies the defined range of text from a text buffer to the specified file. 
Does not change the contents of the text buffer. Without a range, EDT 
copies the contents of the current text buffer to the file. 

Qualifiers: 

SEQ[UENCE][:initial[:increment]] EDT writes the line numbers as a part 

of the output file. 

CHARACTER MODE KEYPAD EDITING COMMANDS 

The keypad editing functions are those used when you enter Character Mode 
with the EDT CHANGE command and set the terminal to use the keypad keys 
with the SET KEYPAD command. You can also use all line mode commands 
with the Gold Command keys. 


DELETE 
GOLD integer 

LINE FEED 

CTRL/A 

CTRL/C 

CTRL/D 

CTRL/E 

CTRL/K 

CTRL/T 

CTRL/U 

CTRL/W 

CTRL/Z 


Erases the character to the left of the cursor 

Repeats any keypad function except SPECINS, DELETE, and 
CTRL/U 

Erases the word to the left of the cursor 
Computes tab level 

Aborts the current command and returns EDT to keypad edit¬ 
ing 

Decreases tab level 

Increases tab level 

Defines key 

Adjusts tabs 

Deletes to start of line 

Refreshes screen 

Returns to line-editing prompt 


NONKEYPAD CHANGE MODE COMMANDS 

Nokeypad commands have only one format, described below. They can be used 
in a series without any delimiter between commands. However, no abbreviations 
are allowed. 
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ADVANCE HADV 

Sets all commands forward (to the right and down from the current cursor 
position). [-]ADV sets commands backward (to the left and up from the 
current cursor position). 

APPEND [ + !-|fcountlAPPEND[+ !-|| entity-count] 

[+ !-]entity[=buffer] 

Moves the specified entities to another text buffer and deletes the text from 
the current buffer. Buffer names the receiving text buffer. If no buffer is 
specified, EDT uses the PASTE buffer. 

ASCII [count]ASC 

EDT displays an ASCII character when you specify the character’s decimal 
number representation. 

BACK BACK 

Sets all commands backward (to the left or up from the cursor). Override 
with a plus sign preceding another command. 

CHANGE CASE CHGCfentityl 

Changes the case of the characters within an entity. 

CUT [+ :-j[rep]CUT[ + !-]|entity-count][+ ! -]entity|=buffer] 

Deletes the moved text from the current text buffer and moves it to the 
specified text buffer, or to the paste buffer if no other buffer is specified. 
Deletes previous contents of the receiving text buffer. 

DELETE [+ :-]freplD[+ ! -]f entity-count]! + !-]entlty|=buffer] 

Deletes a specified number of entities. 

DEFINE KEY DEFK 

Defines the keystrokes used in keypad editing in terms of nokeypad com¬ 
mands. 

EXIT EX 

Exits EDT from nokeypad editing back to line editing. 

EXTENDED EXT 

Enters line mode commands when EDT is in character mode. Returns to 
change mode after executing the command. 
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FILL [ + !-]|rep]FILL[+ : —](entity-count]! + ! -lentlty[=buffer] 

Places the maximum amount of text on each line within the limit deter¬ 
mined by the SET WRAP command. Default: 80 characters. 

INSERT I 

Prepares the current text buffer for insertion of text in front of the cursor 
position. 

NULL f + !-lfrep][+ !-||entity-count|| + i-||entity|| buffer| 

Moves the cursor the specified number of entities. 

PASTE PASTE 

[+ !-l|rep]PASTE[ + 1 —||entity-count|| + !-|entity| buffer) 

Copies the contents of the specified text buffer in front of the current cursor 
location. 

QUIT QUIT 

Ends the editing session without saving any edits and returns to the moni¬ 
tor (CLI) prompt. 

REPLACE R 

1 -]|rep]R[ + !-|| entity-count|| !-]entity| buffer] 

Deletes the text specified and enters insert mode so that you can replace 
the deleted text. To exit from insert mode here, press Ctrl/Z) . 

REFRESH REF 

EDT refreshes the entire screen. 

SUBSTITUTE \ + : -][countlS/s1/s2 

Replaces one string of characters with another. Count defines the number 
of substitutions and minus (-) indicates a backward search. Use any nonal- 
phanumeric character as a delimiter, in place of the /. 

SELECT SEL 

Lets you select a range of text by entering SEL at one end and moving the 
cursor to the other end. The select range is the text between the cursor and 
the position marked by SEL. 

SHIFT LEFT [countlSHL 

Shifts the screen image to the left. The amount shifted is equal to the 
count you specify times 8 (one tab stop). The default count is 1. 
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SHIFT RIGHT [countlSHR 

Shifts the screen image to the right. The amount shifted is equal to the 
count you specify times 8 (one tab stop). 

SUBSTITUTE NXT [+ ! -][count]SN 

Uses the si and s2 defined in the last substitute command to replace the 
next occurrence of si with s2. Count defines the number of substitutions, 
and a minus (-) sign indicates a backward search. 

TAB TAB 

When no tab size is specified with SET TAB or when the cursor is not at 
the beginning of a line, TAB inserts a tab character at the cursor position. 

When a tab size is specified with SET TAB, and the cursor is at the 
beginning of a line, TAB moves the cursor to the column position specified 
in the SET TAB command. 

TAB ADJUST [+ ! -][rep]TADJ[+ I -][entity-countl 
[+! -]entlty[=bufferj 

Adjusts the tab level for the selected range of lines. 

TAB COMPUTE TC 

Sets the indentation level count to the value obtained by dividing the 
current cursor column position by the SET TAB number. 

TAB DECREMENT [countlTD 

Decreases the indentation level count. 

TAB INCREMENT [count]TI 

Increases the indentation level count. 

TOP TOP 

Places the current line at the top of the screen. 

UNDELETE CHARACTER [countjUNDC 

Inserts the last character deleted by a DELETE CHARACTER command 
into the current text buffer (in front of the cursor). 

UNDELETE WORD (count]UNDW 

Inserts the last word deleted by a DELETE WORD command into the 
current text buffer (in front of the cursor). 
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UNDELETE LINE [countlUNDL 

Inserts the last line deleted by a DELETE LINE command into the current 
text buffer (in front of the cursor). 

CIRCUMFLEX fcountr[A...Z] 

Inserts a control character in the text buffer. 

LINE RANGES: 

Most EDT commands allow you to specify a range of text on which the action of 
the command is performed. These ranges are: 


Single Line Ranges: 


.(period) 

Current location of cursor. 

number[.decimal] 

The line number specified. 

-'string' ! -"string" 

The most recent preceding line containing the string 
specified. Without a string specification, EDT uses 
the last search string. 

[range]+[number] 

The line that is the specified number of lines after 
the specified range. 

[range]-[number] 

The line that is the specified number of lines before 
the specified range. 

BEGIN 

The first line in the text buffer. 

END 

An empty line following the last line in the text 
buffer. 

LAST 

The last line in the most recent text buffer before the 
current text buffer. 

ORIGINAL number 

The line numbers assigned to the text in the main 
text buffer from the primary input file. You can lo¬ 
cate text by its original line number even after it has 
been assigned new numbers. 


Contiguous Line Ranges: 

[range-1 ]:[range-2] The set of lines from range-1 through range-2 inclu- 


[range]#number! 
[range]FOR number 

sive. Range-1 and Range-2 are any single line range 
specification. 

The specified number of lines beginning with range, 
where range is any single line range specification. 
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BEFORE 

REST 

WHOLE 

Noncontiguous Ranges: 

[range,range,...]! 

[range AND range...] 

[range]AII 'string' 

Text Buffer Ranges: 

[=buffer][range]! 
[BUFFER buffer][range] 


All lines preceding the current line in the current 
buffer. 

All lines after and including the current line. 

The current text buffer. 

All lines specified by each range, which must be 
single line range. 

All lines in the range containing the specified string. 


When you use a buffer without a range specification, 
the default is the entire text buffer and the cursor is 
placed at the First line in the text buffer. 
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Command lines for the File Exchange utility (FLX) use the following format: 
outfile/sw=infile(,s)/sw 

FLX assumes the following defaults if no switches are specified on the command 
line: 

Input volume DOS-11 

Output volume FILES-11 

FLX switches are: 

BLOCKS outfile/BL:n(.| infile 

Specifies the number of contiguous blocks (n) in octal or decimal to be 
allocated to the output file. 

BLOCK SIZE outfile/BS:n=infile 

Specifies the block size (n) for cassette tape output. 

CONTIGUOUS outfile/CO infile 

Specifies that the output file is to be contiguous. 

DELETE outfile/DE infile|/DE| 

Deletes files from a DOS-11 or RT-11 (used with the /RT switch) volume. 

DIRECTORY outfile/DI infile 

Causes a directory listing of a cassette or DOS-11 volume or, when used 
with the /RT switch, of an RT-11 volume. The directory is placed in the 
specified output file. 

DENSITY outfile/DNS:n=infile 

Specifies a density of 800, 1600, or 6250 bpi for a magnetic tape volume. 

DOS-11 outfile/DO infile|/DO| 

Identifies the volume as a DOS-11 formatted volume. 

FORMATTED ASCII outfile/FA:n=infile 

Specifies formatted ASCII transfer mode file format. 
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FORMATTED BINARY outfile/FB:n Inflle 

Specifies formatted binary transfer mode file format. 

FORTRAN CONTROL outfile/FC infile 

Specifies that FORTRAN carriage control conventions are to be used. 

IDENTIFICATION /ID 

Displays the current version number of FLX. 

IMAGE MODE outfile/IM:n=infile 

Specifies image mode (n is in decimal bytes). 

LIST outdevice/LI 

Same as /DI. 

NUMBER outfile/ZE/NU:n[.Hnfile 

Used with /ZE and /RT switches; specifies the number of directory blocks 
(n) in octal or decimal to allocate when you are initializing an RT-11 disk 
or DECtape. 

RSX FORMAT outfile/RS infile|/RS| 

Identifies the volume as a Files-11 formatted volume. 

RT FORMAT outfile/RT infile|/RT] 

Identifies the volume as an RT-11 formatted volume. 

REWIND outfile/ HRW infile|/RW] 

Specifies whether a magnetic tape will rewind before FLX begins the file 
transfer. 

SPOOL outfile/SP infile 

Specifies that the converted file is to be spooled by the print spooler or the 
Queue Manager. 

UIC outfile/UI infile 

Specifies that the output file is to have the same UFD as the input file. 

VERIFY outfile/VE infile 

Verifies each record written to a cassette. 
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ZERO outfile/ZE infile/RT 

Initializes cassettes or DOS-11 volumes or, when used with the /RT switch, 
RT-11 volumes. Initializing erases any files already on the volume. 
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FMTCOMMAND SUMMARY 


Command lines for the Disk Volume Formatter (FMT) use the following format: 
FMT ddn:[/switchl.../switchn] 

In this command line, dd is the abbreviation for the volume being formatted and 
n is the unit number of the volume. 

FMT switches are: 

BAD ddn:/BAD 

Runs the Bad Block Locator Utility if it is installed. Note that you can use 
this switch only with operating systems that allow spawning of tasks. 
RSX-11M provides spawned tasks as a system generation option. 

DENSITY ddn:/DENS=n 

Selects high (double) or low (single) density for RX02 floppy diskettes. The 
value n can be 800 or 1600. 

ERROR LIMIT ddn:/ERL=n 

Determines the maximum number of errors FMT allows on the volume. 

MANUAL ddn:/MAN 

Enters manual operating mode and formats the sector or track you specify. 

NOVERIFY ddn:/-VE 

Inhibits the default verification of a successful FMT operation. 

OVERRIDE ddn:/OVR 

Overrides or ignores the manufacturer’s bad block sector file (MDBSF). 

VERIFY ddn:/VE 

Verifies that an FMT operation was successfully completed. This switch is 
the default. 

WRITE LAST TRACK ddn:/WLT 

Rewrites the MDBSF (on the last track of the device) to add bad sectors 
found during an FMT operation. 
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FMT Command Summary 


INDIRECT ddn:/@Y 

Informs FMT that it is receiving input from an indirect command File. User 
intervention is not allowed during the operation. 


44 





LBR COMMAND SUMMARY 


Command lines for the Librarian utility (LBR) use the following format: 

outfile[/sw][,listfile]=infilel[,infile2,...infilen][/sw] 

LBR switches are: 

COMPRESS outfile/CO:size:ept:mnt=infile 

Compresses a library file by physically deleting logically deleted records, 
putting the free space at the end of the file, and making the free space 
available for new library module inserts. 

CREATE outfile/CR:size:ept:mnt:libtype:def.ext=infiletype 

Allocates a contiguous library file on a direct access device (for example, a 
disk). 

DELETE outfile/DE:module1|:module2...:modulen| 

Logically deletes library modules and their associated entry points from a 
file. 

DEFAULT outfile/DF:type... 

or 

/DF:type 

Specifies the default library file type. 

DELETE GLOBAL outfile/DG:global1|:global2:...:globaln| 

Deletes the specified library module entry points from the entry point 
table. 

ENTRY POINT outfilef/EPl=infile[...,infilenl 

or 

outfile=infile[/EP|[...,infilen[/EP]] 

Includes or excludes entries in the entry point table. 

EXTRACT outfile=infile/EX[:modulename1:...:modulenamen] 

Reads (extracts) one or more modules from a library and writes them into 
the specified output file. 
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LBR Command Summary 


INSERT outfile/IN infilel| ,infile2...Jnfilen| 

or 

outfile infile/IN:name:op:op:op:op (universal) 

Inserts library modules into a library file. 

LIST outfile|,listfile|/switch(es) 

Lists all modules in the library file plus additional information, depending 
on which form of the switch you use: 

/LI Lists all modules in the library file. 

/LE Lists all modules in the library file and their corresponding en¬ 

try points. 

/FU Lists all modules in the library file and provides a full module 
description that includes the size, date of insertion, and 
module-dependent information. 

MODIFY HEADERS outfile/MH:module:op:op:op:op 

Modifies the optional user-specified information in the module header of a 
universal library. 

REPLACE outfile/RP infile1|,infile2...,infilen| (global format) 

outfile infile1/RP(,infile2|/RP|...,infilen[/RPH (local format) 
outfile/RP:name:op:op:op:op=lnfile1[,infile2...,infilen](universal/global format) 
outfile infile1/RP:name:op:op:op:op|,infile2...,infilen|(universal/local format) 

Replaces or, in certain cases, inserts library modules in a library file. 

SPOOL outfile,listfile/SP 

Spools the listing file for printing. This is the default setting; use /-SP to 
prevent the file from being printed. 

SELECTIVE outfile Hnfile1/SS|,infile2|/SS|...,infilen|/SS|| 

Sets the selective search attribute bit in the object module header. 

SQUEEZE outfile/SZ infile1|,infile2...,infilen| (global format) 

outfile infile1/SZ|,infile2[/SZ]...,infilen|/SZl| (local format) 

Reduces the size of macro definitions by removing comments, blank lines, 
and trailing blanks and tabs from the macro text. 
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SLP COMMAND SUMMARY 


Command lines for the Source Language Input Program (SLP) use only the 
following format: 

outfile[/switch,listfile/SP or /-SP]=infile[/switch] 

SLP switches have the same effect and can be used on either input or output file 
specifications, except for the /SP, switch which can only modify the listfile. 
These switches are: 

AUDIT TRAIL outfile/ |-|AU infile 
outfile=infile/ |-|AU 

Enables or disables the audit trail, which indicates the changes made 
during the most recent editing session. 

BLANK FILL outfile/HBF=inflle 
outfile infile/ |-|BF 

Enables or disables blank fill (right-justification) for an audit trail. 

COMPRESS outfile/ f-]CM=infile 
outfile infile/ |-|CM 

Deletes the audit trail and any trailing spaces or tabs, and truncates the 
text at the specified horizontal position. 

CHECKSUM outfile/CS[:n| infile 
outfile infile/CS|:n| 

Calculates the checksum value for the edit commands. 

DOUBLESPACE outfile/ |-|DB=infile 
outfile infile/|-|DB 

Enables or disables double-spaced listings. /-DB is the default switch. 

NO SEQUENCE outfile/NS infile 
outfile infile/NS 

Does not sequence lines in the output file. New lines are indicated by the 
audit trail (if specified). This switch overrides the /RS and /SQ switches. 

RESEQUENCE outfile/RS infile 

outfile infile/RS 

Resequences the lines in the output file so that the line numbers are incre¬ 
mented for each line written to the output file. 
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SLP Command Summary 


SPOOL outfile,listfile/ |-|SP infile 

Enables or disables the spooling of listing files to a line printer. This switch 
applies only if the print spooler task (RSX-11M) or the Queue Manager 
(RSX-11M/M-PLUS) is installed. 

SEQUENCE outfile/SQ infile 


outfile infile/SQ 


Sequences the lines in the output file so that the numbers reflect the line 
numbers of the original input file. 


TRUNCATE outfile/TR infile 
outfile=infile/TR 


Specifies that a diagnostic error message occurs when lines are truncated 
by the audit trail. 

SLP uses the following special operators, in edit mode, to perform specific 
functions: 


Operator 


Function 


© 

/ 


\ 


% 


< 


Identifies the dash as the first character of a SLP edit command 
line 

Suppresses audit trail processing 

Reenables audit trail processing 

Invokes an indirect file for SLP processing 

Terminates the SLP edit session and returns to SLP command 
mode 

Allows characters in the input file that SLP would normally use 
as operators 
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PAT COMMAND SUMMARY 


PAT command lines use the following format: 

[outfilel=infile[/CS[:number]],correctfile[/CS[:number]] 

In this command line, outfile is the file specification for the output file, infile is 
the file specification for the input file containing one or more concatenated 
object modules, and correctfile is the specification for the correction file contain¬ 
ing updates to be applied to one module in the input file. 

The only PAT switch is: 

CHECKSUM |outfile|=infile/CS[:n],correctfile[/CS[:n]] 

Directs PAT to calculate the checksum for all the binary data that consti¬ 
tutes the module. PAT displays this checksum in octal. 
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PERIPHERAL INTERCHANGE PROGRAM 
(PIP) COMMANDS 


Default Operation 

The default PIP operation (with no switches) is to copy the specified files, using 
the following format: 


outfile = infile(,s)|/subswitches| 

PIP allows the following parameters for this command: 

outfile If the command does not specify a file name, file type, or 
version number, PIP uses the input name and type and the 
next highest version number. 

If the command specifies a file name, file type, or version 
number, no other field can be a wildcard and the command 
line can only specify <?ne input file. 

infile If the command does not specify file name, file type, or ver¬ 

sion number, the default is *.*;*. 


subswitches: 

/BL:n[.] Specifies the number of contiguous blocks allocated for the 
output file, where n is octal or decimal. 

If n is decimal, it is followed by a period (n.). 


/CO, /-CO, 
or /NOCO 

/FO 

/NV 

/SU 


Specifies a contiguous or noncontiguous output file. 

File ownership (output file UFD). 

Forces the output version number of the copied file to be 1 
higher than the current highest version. 

Copies the output file, superseding an existing file. 


APPEND outfile[/FO] = infile(s)/AP[/FO] 

Opens an existing file and appends the input files, infile(s), to the end of it. 
PIP allows the following parameters for this command: 
outfile Explicit file name and file type. 
infile(s) Explicit file parameters; wildcard by default. 


/FO File ownership is the output file UFD; without /FO, owner¬ 

ship is the UIC of the user running PIP. 


51 





Peripheral Interchange Program (PIP) Commands 


BLOCKSIZE outfile/BS:n = infile(,s) 

Defines the block size for magnetic tape. 

CREATION DATE outfile/CD = infile(,s) 
outfile = infile/CD 

Gives the output file the creation date of the input file rather than the date 
of the file transfer. (This switch cannot be used with the merge switch or 
with a magnetic tape as an output device.) 

DATE /DA:startdate:enddate 

Restricts file searches to files created during the specified period of time. 

DELETE infile(s)/DE[/LD] 

Deletes files. /LD is a subswitch that causes PIP to list the files it deletes. 


DEFAULT [ddn:][UFD]/DF 

Changes the default device and/or UFD for the current PIP task. 


END-OF-FILE infile/EOF[:block:byte| 

Specifies the end-of-file pointers for a file. If values for block and byte are 
not entered, PIP places EOF at the last byte of the last block in the file. 

ENTER outfile = infile(s)/EN[/NV] 

Enters a synonym for a file in a directory on the same device, with an 
option to force the version number of the output file to 1 greater than the 
latest version for the file. 

outfile The file name, file type, or file version can be explicit, a 
wildcard, or null. A field that is a wildcard or null assumes a 
corresponding input field. 

infile Default for the file name, file type, and file version is *.*;*. 

/NV Forces a new version of the file. 


EXCLUDE fllespec/EX 

Excludes one file specification during a search. 


FILE ID outfile = /Fl:filenumber:sequencenumber 

Accesses a file by its file identification number (File ID). 
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Peripheral Interchange Program (PIP) Commands 


FREE fddn:] /FR 

Displays on the terminal the amount of space available on a volume, the 
largest block of contiguous space, the number of available file headers, and 
the number of headers used. 

IDENTIFICATION /ID 

Identifies the version number of PIP currently in use and whether PIP is 
linked to ANSFCS. 

LIST [listfile = ]infile(s)/LI[/subswitch] 

Lists the contents of one or more UFDs, with an option to specify formats 
for output directories. 

outfile Listing file specifier; defaults to TI:. 

infile Default is *.*;*. 

The subswitches determine what type of report is displayed. 

/LI/BR 

or /BR Brief report. 

/LI Limited report. 

/LI/FU:n 

or /FU:n Full report (n specifies the decimal characters per line; the 
default is device buffer size). 

/LI/TB 

or /TB Total blocks report. 

/LI & /TD 

or 

/TD/LI Files created on current day. The /TD switch alone does not 
generate a directory listing. 

MERGE outfile = infile(,s)/ME[/subswitch(es)| 

Creates one file by concatenating two or more files. The legal subswitches 
are: 

subswitches: 

/BL:n[.] Specifies the number of contiguous blocks allocated for the 
output file, where n is octal or decimal. 

If n is decimal, it is followed by a period (n.). 
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Peripheral Interchange Program (PIP) Commands 


/CO, /-CO, 

or /NOCO Specifies a contiguous or noncontiguous output file. 

/FO File ownership (output file UFD). 

/NV Forces the output version number of the copied file to be 1 

higher than the current highest version. 

/SU Copies the output file, superseding an existing output file. 

NO MESSAGE infile(s)/NMf/sw] 

Causes certain PIP error messages not to be displayed: for example, the 
message NO SUCH FILE(S). The switches that can be used with the NM 
switch are: 

/LI Lists directory. 

/DE Deletes file(s). 

/PU Purges file(s). 

/UN Unlocks file(s). 

You can also use any subswitches of these switches. 

PROTECTION SYMBOLIC: infile/PR[/SY[:RWED][/OW(:RWEDH 

[/GR[:RWED]]f/WO[ :RWED]][/FO] 

Alters the file protection for the file specified. The file name and file type 
must be explicit. 

Symbolic protection codes assign privilege merely by their presence, using: 

System = /SY:RWED 
Owner = /OW:RWED 
Group = /GR:RWED 
World = /WO:RWED 

The symbolic codes are: 

R read 
W write 
E extend 
D delete 
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Peripheral Interchange Program (PIP) Commands 


Numeric protection denies privilege by setting bits in a protection status 
word. Add octal values from the following list to deny privilege. 


User 




Class 

Privilege 

Octal Code 

Bit 

System 

R 

1 

0 


W 

2 

1 


E 

4 

2 


D 

10 

3 

Owner 

R 

20 

4 


W 

40 

5 


E 

100 

6 


D 

200 

7 

Group 

R 

400 

8 


W 

1000 

9 


E 

2000 

10 


D 

4000 

11 

World 

R 

10000 

12 


W 

20000 

13 


E 

40000 

14 


D 

100000 

15 


PURGE infile(s) /PU[:nlf/LDJ 

Deletes a specified range of versions of a file (but does not delete the latest 
version). Specification of a file version number is not necessary. Wildcards 
are valid for file name and file type. 

When :n is specified, PIP deletes all but the n latest consecutively 
numbered versions. Without :n, PIP deletes all but the latest version. 

REMOVE infile(s) /RM 

Removes an entry from a UFD, but does not delete the file. 
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Peripheral Interchange Program (PIP) Commands 


RENAME outfile = infile(s)/RE|/NV] 

Changes the name of the file specified. Used with the /NV switch, /RE 
creates an output file with a version number 1 higher than the latest 
version of the file. 

outfile A wildcard (*) or null field assumes the value of the corre¬ 
sponding field in the input file. 

infile Null file name, file type, and file version default to *.*;*. 

/NV See COPY. 

REWIND outfile/RW = infile 
outfile = infile /RW 

outfile Causes the tape on the specified unit to be rewound and 
erased. 

infile Causes the tape on the specified unit to be rewound before 

the input file is opened. 

SELECTIVE DELETE infile(s)/SD 

Prompts for user response before deleting files. 

SHARED READING infile(s)/SR 

Allows shared reading of a file that has already been opened for writing. 

SPAN BLOCKS outdsk:outfile/SB = inmag:infile 

Allows output file records to cross block boundaries when ANSI tapes are 
being copied to Files-11 volumes. 

SPOOL infile(s)/SP[:n] 

Specifies a list of files to be printed on a line printer, n is the number of 
copies. This switch applies only if you have the Serial Despooler or the 
Queue Manager. However, using it with the Queue Manager is not recom¬ 
mended. 

TRUNCATE infile(s)/TR 

Truncates files to their logical end-of-file point. 
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Peripheral Interchange Program (PIP) Commands 


USER FILE DIRECTORY ENTRY outfile(s)/UFf/FO] = Infile(s) 

Creates a User File Directory entry in the Master File Directory on a 
volume. 

outfile Specifies the UIC as [*,*] to transfer multiple infile UICs. 
/FO See APPEND. 

UNLOCK infile(s)/UN 

Unlocks a file that was locked as a result of being closed improperly. 

UPDATE FILE outfile = infile(s)/UP[/FO] 

Opens an existing file and writes new data (infile) in it, from the beginning, 
outfile Must be explicitly identified. 

infile Null parameters default to *.*;*• Input file(s) replace the 

current contents of output files. 
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QUEUE MANAGER 


This section describes the Queue Manager commands for RSX-11M. It includes 
syntax to use the commands from either DCL or MCR. 

DELETE 

Deletes queues or QMG jobs by name or by the job’s unique entry number. 

Format 

DCL>DELETE/JOB queuename jobname[FILE_POSITION:nl 

DCL>DELETE/ENTRY:nnn[/FILE_POSITION:n] 

MCR>QUE queuename:jobname/FI:n/DEL 
MCR>QUE /EN:nnn/FI:n/DEL 

HOLD AND RELEASE 

You can specify that a job be held when you issue your PRINT or SUBMIT 
command. You can also hold jobs with the HOLD command and release such 
jobs with the RELEASE command. 

HOLD (QUE /HO) blocks a job in its queue until it is explicitly released. 
RELEASE (QUE /RE) unblocks a job that has been held in queue. 

Format 

DCL>HOLD/JOB queuename jobname 
DCL>HOLD/ENTRY:nnn 
MCR>QUE queuename:jobname/HO 
MCR>QUE /EN:nnn/HO 
DCL>RELEASE/JOB queuename jobname 
DCL>RELEASE/ENTRY:nnn 
MCR>QUE queuename:jobname/REL 
MCR>QUE /EN:nnn/REL 

PRINT 

Queues files for printing on a line printer or use on other output devices. 

Format 

DCL>PRINT/commandqualifier[s] file[s]/filequalifier[s] 

MCR>PRI [queuename:][jobname][/jobswitch][ ]file[s][/fileswitch[s]] 
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Queue Manager 


DCL Command Qualifiers 

MCR Job Switches 

/JOBCOUNT:n 

/CO:n 

/QUEUE:queuename 

queuename: 

/UPPERCASE 

/NOLO 

/LOWERCASE 

/LO 

/[NO]HOLD 

/[NO]HO 

/PAGE_COUNT :n 

/PA:n 

/NAME:jobname 

jobname= 

/PRIORITY:n 

/PRIO:n 

/FORMS:n 

/FO:n 

/LENGTH:n 

/LE:n 

/[NO]RESTART 

/[NO]RES 

/[NO]FLAG_PAGE 

/[NO]FL 

/AFTER:(dd-mmm-yy hh:mm) /AF:hh:mm:dd-mmm-yy 

/DEVICE:ddnn: 

queuename: 

/NOJOBPAGE 

/NOJO 

DCL File Qualifiers 

MCR File Switches 

/[NOJDELETE 

/[NOJDEL 

/COPIES:n 

/CO:n 

SET QUEUE 


Modifies attributes given to print jobs, batch jobs, or files that compose jobs in 
queues. Such jobs and files have been entered in queues by the PRINT com- 

mand. 


Job Format 


DCL>SET QUEUE queuename:jobname/qualifier[/qualifier[s]] 

DCL>SET QUEUE /ENTRY:nnn/qualifier[/qualifier[s]] 

MCR>QUE queuename:jobname/MOD/switch[/switch[s]] 

MCR>QUE /EN:nnn/MOD/switch/[/switch[s]] 

DCL Qualifiers 

MCR Switches 

/AFTER:(hh:mm dd-mmm-yy) /AF:hh:mm:dd-mmm-yy 

/JOBCOUNT:n 

/CO:n 

/FORMS:n 

/FO:n 

/LENGTHin 

/LE:N 

/LOWERCASE 

/LO 

/PAGE_COUNT :n 

/PA:n 

/PRIORITY:n 

/PRIO:n 

/[NO]RESTART 

/[NO]RE 

/UPPERCASE 

/NOLO 
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Queue Manager 


File Format 

DCL>SET QUEUE/ENTRY:nnn/FILE—POSITION:n/qualifier[/qualifier[s]] 

DCL>SET QUEUE queuename jobname/FILE_ 

POSITION:n/qualifier[/qualifier[s]] 

MCR>QUE /EN:nnn/MOD/FI:n/switch[/switch[s]] 

MCR>QUE queuename:jobname/MOD/FI:n/switch[/switch[s]] 

DCL Qualifiers MCR Switches 

/COPIES:n /CO:n 

/[NO]DELETE /[NO]DEL 

SHOW PROCESSOR 

Displays information about the initialized characteristics printers, and other 
devices under control of the Queue Manager. 

Format 

DCL>SHOW PROCESSOR/qualifier 
MCR>QUE [processorname:]/switch 

DCL Qualifiers MCR Switches 

processorname[:] /LI:DEV 

/PRINT or /DEVICE /LI:DEV:P 

/INPUT or /CARD_READER ,/LI:DEV:l 


SHOW QUEUE 


SHOW QUEUE displays information about QMG print jobs. 

Format 

DCL>SHOW QUEUE [queuename]/qualifier[s] 
MCR>QUE [queuename:][[uic]][jobname]/switch[s] 


DCL Qualifiers 

/FULL 

/FILES 

/BRIEF 

/DEVICE 

/ENTRYrnnn 

/FORMS[:n] 

/NAME:jobname 

/OWNER_UIC:uic 

/PRINT 


MCR Switches 

/FU 

/LI 

/BR 

/LI:P 

/ENrnnn 

/FO[:n] 

jobname 

[uic] 

/LI.P 
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ZAP COMMAND AND SWITCH SUMMARY 


Invoke ZAP before you enter the ZAP command line, using the following format: 

ddnn:[ufd]filename,filetype;version[/sw...] 

You cannot enter a file specification on the command line when you invoke ZAP. 

In this command, the file specification is the task image file to be examined or 
modified. The default file type is .TSK and the default version is the latest one. 

ZAP command lines use the following switches: 

ABSOLUTE ddnn:filespec/AB 

Specifies absolute mode. 

LIST ddnn:filespec/LI 

Displays the overlay segment table for an overlaid task image file. 

READ-ONLY ddnn:filespec/RO 

Specifies read-only mode. 

ZAP Open/Close Commands 

ZAP uses the following commands to examine or modify a task image file: 

/ (slash) 

Opens a location, displays its contents in octal, and stores the contents of 
the location in the Quantity Register (Q). If the location is odd, it is opened 
as a byte. 

" (quotation mark) 

Opens a location, displays the contents of the location as two ASCII char¬ 
acters, and stores the contents of the location in the Quantity Register (Q). 

% (percent sign) 

Opens a location, displays the contents of the location in Radix-50 format, 
and stores the contents of the location in the Quantity Register (Q). 

\ (backslash) 

Opens a location as a byte, displays the contents of the location in octal, 
and stores the contents of the location in the Quantity Register (Q). 
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ZAP Command and Switch Summary 


' (apostrophe) 

Opens a location, displays the contents as one ASCII character, and stores 
the contents of the location in the Quantity Register (Q). 

<RET> (RETURN key) 

Closes the current location as modified and opens the next sequential 
location if no other values or commands are on the command line. ZAP 
commands take effect only after you press the RETURN key. 

" or (circumflex or up arrow) 

Closes the currently open location as modified and opens the preceding 
location. 

_(underscore) 

Closes the currently open location as modified, uses the contents of the 
location, as an offset from the current location, and opens the new location. 

@ (at sign) 

Closes the currently open location as modified, uses the contents of the 
location as an absolute address, and opens that location. 

> (right angle bracket) 

Closes the currently open location as modified, interprets the low-order 
byte of the contents of the location as the relative branch offset, and opens 
the target location of the branch. 

< (left angle bracket) 

Closes the currently open location as modified, returns to the location from 
which the last series of underscore (—), at sign (@), and/or right angle 
bracket (>) commands began, and opens the next sequential location. 

General-Purpose Commands 

X 

Exits from ZAP and returns control to the CLI. 

K 

Calculates the offset in bytes between an address and the value contained 
in a Relocation Register, displays the offset value, and stores it in the 
Quantity Register (Q). 
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ZAP Command and Switch Summary 


O 

Displays the jump and branch displacements from the current location to a 
target location. 

Displays in octal the value of the expression to the left of the equal sign. 

V 

Verifies the contents of the current location. 

R 

Sets the value of a Relocation Register. 
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MONITOR CONSOLE ROUTINE (MCR) COMMANDS 


In this section, (P) indicates that a command format or keyword is privileged. 

ABORT ABO taskname [/keyword] 

Keyword: PMD 

Terminates execution of the specified task. You can request a Postmortem 
Dump with the /PMD keyword. 

ACTIVE ACT [/keyword] 

Keywords: ALL 

TERM=TTnn: 

Displays on the terminal all tasks issued from that terminal, all tasks 
active in the system, or all tasks issued from a specified terminal. 

ACTIVE TASK LIST ATL [taskname] 

Displays the name and status of all active tasks in the system, or the status 
of the particular task specified. 

ALLOCATE ALL dd[nn:][=llnn:][/keyword] 

Keywords: TERM=TTnn: 

TYPE=dev 

Establishes the specified device as the user’s private device on multiuser 
protection systems. Privileged users can allocate a device to any terminal, 
using the /TERM keyword, but nonprivileged users can only allocate de¬ 
vices to their own terminals. 

Specifying dd allocates the first logical unit of the dd-type device (for 
example, DM1:). Specifying the /TYPE keyword allocates the first avail¬ 
able dev-type device (for example, RK07). Specifying =llnn: creates a logi¬ 
cal device name and assigns it to the physical device being allocated. 

ALLOCATE CHECKPOINT SPACE (P) ACS ddnn:/BLKS=n. 

Allocates or discontinues a checkpoint file on disk for systems that support 
the dynamic allocation of checkpoint space. The /BLKS keyword specifies 
the number of blocks to be allocated to the checkpoint file. Use n=0 to 
discontinue use of a checkpoint file. 
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Monitor Console Routine (MCR) Commands 


ALTER ALT tasknamef/keyword] (P) 

Keywords: PRI=static and running priority 
RPRI=running priority only 

Changes the static or running priority of an installed task. 

ASSIGN ASN ppn:=llnn: [/keyword] 

Keywords: GBL 
LOGIN 

TERM=TTnn: 

Defines, displays, or deletes logical device assignments as follows: 

Local assign operations 

ASN ppn:=llnn: 

ASN ppn:=llnn:/TERM=TTnn: (P) 

Login assign operations 

ASN ppn:=llnn:/LOGIN (P) 

ASN ppn:=llnn:/LOGIN/TERM = TTnn: (P) 

Global assign operations 

ASN ppn:=llnn:/GBL (P) 

Local display operations 

ASN 

Login display operations 

ASN /TERM-TTnn: (P) 

Global display operations 

ASN /GBL (P) 

Local delete operations 

ASN = 

ASN = linn: 
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Monitor Console Routine (MCR) Commands 


Login delete operations 

ASN =/LOGIN (P) 

ASN =/LOGIN/TERM=TTnn: (P) 

ASN =/TERM=TTnn: (P) 

ASN =/llnn:/TERM=TTnn: (P) 

ASN =/llnn:/LOGIN (P) 

ASN =/llnn:/LOGIN/TERM=TTnn: (P) 

Global delete operations 

ASN =/GBL (P) 

ASN = llnn:/GBL (P) 

BLOCK BLK [taskname] 

Declares that the specified task is ineligible to execute or to compete for 
memory resources. Nonprivileged users can block only tasks running from 
their own terminals. Privileged users can block any task. However, ACP 
tasks, CLI tasks, tasks being aborted, and halted tasks cannot be blocked. 

BOOT BOO [filespec] (P) 

Bootstraps a system that exists as a task image file on a Files-11 volume. 

BREAKPOINT TO XTD (P) BRK 

Passes control to the Executive Debugging Tool (XDT). 

BROADCAST BRO TTnn: message 
BRO @filespec 
BRO ALL:message (P) 

BRO LOG:message (P) 

Displays the specified message at one terminal for a nonprivileged user, or 
at a number of terminals for a privileged user. 

BYE BYE [/keyword] 

Keyword: [NOJHOLD 

Logs the user out of a multiuser protection system, optionally specifying 
that the full-duplex terminal driver not hang up a remote line or that 
DECnet not break the connection. 

CANCEL CAN taskname 

Cancels time-based initiation of a task. Privileged users can cancel any 
task, but nonprivileged users can cancel only tasks that they initiated. 
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COMMAND LINE INTERPRETER CLI /keyword=cliname 

Keywords: DISABLE=cliname 

ELIM=cliname or ELIM=* 

ENABLE=cliname 

INIT=cliname[/subkeyword(s)] 

Subkeywords: CPR=“string” 

DISABLE 

DPR=“string” 

LGO 

MESSAGE 

NULL 

PRIV 

PROMPT 

QUIET 

RESTRICT 

SNGL 

TASK=taskname 

MESSAGE=cliname:“message-text” 

SHOW 

UNOVR 

Sets up for use a command line interpreter other than MCR, such as DCL 
or a user-written CLI. 

CLOCK QUEUE CLQfUEUE] 

Displays on the entering terminal information about tasks currently in the 
clock queue. 

DEALLOCATE DEA [ddnn:] 

Releases a private (allocated) device where ddnn: is the device name and 
unit number. Privileged users can deallocate any device, but nonprivileged 
users can only deallocate devices that they have allocated. If no device is 
specified, the command deallocates all of the user’s allocated devices. 

DEVICES DEV [/keyword] 

DEV dd: 

DEV ddnn: 

Keyword: LOG 

Displays symbolic names of all devices or of all devices of a particular type, 
or the name of a specific device. The /LOG keyword displays all of the 
logged-in terminals. 
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DIGITAL COMMAND LANGUAGE DCL command-line 

Allows you to issue DCL commands from a terminal that is set to MCR. 

DISMOUNT DMO ddnn:[[“]label(”]][/keyword(s)] 

DMO /USER [/keyword(s)] 

Keywords: DEV (P) 

TERM=TTnn: (P) 

LOCK=option 

Tells the file system to mark the volume for dismount and to release the 
control blocks. Privileged users can dismount any volume, but nonprivi- 
leged users can dismount only devices that they have mounted. 

FIX IN MEMORY (P) FIX taskname 

Loads and locks a task into its partition. 

GROUP GLOBAL EVENT FLAGS FLA[GS] [[ggg]/keyword] 

Keywords: CRE 
ELIM 

For privileged users, creates or eliminates global event flags for any group. 
For nonprivileged users, creates or eliminates group global flags only for 
their own login group. Any user can display all of the group global event 
flags. 

HELLO/LOGIN HEL [uic[/password]] 

HEL fusernamef/password]] 

LOG [uic[/password]] 

LOG [username[/password]] 

Logs you in on a terminal to access a multiuser system. 

HELP HELP [/keyword] [qualifier][qualifier 2||...qualifier 9] 

HELP % [qualifier||qualifier 2||...qualifier 9] 

Keywords: CLhcliname or xxx 
DCL 

FIL:[filespec] 

GRO 

LOC 

MCR 

OUT:filespec 

Displays the contents of a help file on the issuing terminal. 
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HOME HOM ddnn:volume-label/keyword(s) 

Keywords: DENS=density 

EXT=block-count 

FPRO=[system,owner,group,world] 

LRU=directory-count 
MXF=file-count 
NAME=new-volume-label 
OVR (P) 

OWNER=[g,m] 

PRO=[system,owner,group,world] 

UIC=[g,m] 

VI 

WIN=retrieval-pointer-count 

Modifies certain fields in the home block of a Files-11 disk volume. 

INITIALIZE VOLUME INI ddnn:[“]volume-label[”] [/keyword(s)] 

Keywords: ACCESS=“character” 

BAD=[option] 

DENS-density 

EXT=block-count 

FPRO=[system,owner,group,world] 

INDX=index-file-position 

INF=initial-index-file-size 

LRU=directory-count 

MXF=file-count 

OWNER=[g,m] or OWNER=“owner” 

PRO=[system,owner,group,world] 

UIC=[g,m] 

VI 

WIN=retrieval-pointer-count 

Produces a Files-11 volume on disk, magnetic tape, or DECtape. On mul¬ 
tiuser protection systems, you can initialize volumes only on devices that 
you allocated. 

INSTALL INS f$]filespec[/keyword(s)] (P) 

Keywords: CKP=option 
CLI=option 
INC=size 
IOP=option 
PAR=pname 
PMD=option 
PRI=number 
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.> 


Keywords: SLV=option 

TASK=taskname 

/UIC=[g,m] 

Makes a specified task known to the system. 

LOAD LOA dd:[/keyword(s)] (P) 

Keywords: PAR=parname 
SIZE=parsize 
HIGH 

Reads a nonresident device driver into memory and constructs the linkages 
required to allow access to the device. 

LOGICAL UNIT NUMBERS LUN[S] taskname 

Displays the static LUN assignments for a specified task. 

MOUNT 

Allows the file system software access to a physical device. 

Files-11 disk or DECtape format: 

MOU ddnn:[label][/keyword(s)] 

Keywords: ACP=option (P) 

DENS=density 

EXT=block-count 

FOR 

FPRO=[system,owner,group,world] 

LOCK=option 
LRU=directory-count 
OVR (P) 

PARM=“user parameters” 

PRO=option 

PUB 

[NO]SHARE 

UIC=[g,m] 

UNL 

VI 

[NO]WAIT 
WIN =option 
[NOJWRITE 
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Files-11 (ANSI) magnetic tape format: 

MOU device-list:[file-set-ID][/keyword(s)] 

Keywords: ACP=option (P) 

BS=n 

CC=option 

DENS=density 

FOR 

FPRO=[system,owner,group,world] 

[NOJHDR3 
[NOJLABEL 
LOCK= option 
OVR (P) 

OVRACC (P) 

OVREXP (P) 

OVRFSID (P) 

PARM= "user parameters" 

PRO= option 
PUB 
RS= n 

[NOJSHARE 
TR= option 
UIC=[g,m] 

VI 

VOL= (list) 

[NOJWAIT 

[NOJWRITE 

OPEN REGISTER (P) OPEJN] mem-addr[+/-n]f/keyword] 

mem-addr /contents [ctrl-char][value]term 

Keywords: TASK=taskname 

PAR=partitionname 

KNL 

DRV=dd: 

Allows examination and optional modification of a register in memory. 

PARTITION DEFINITIONS PARJTITIONS] 

Displays a description of each memory partition in the system. 

REASSIGN (P) REA taskname lun ddnn: 

Reassigns a task’s static logical unit numbers from one device to another. 
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REDIRECT (P) RED nddnn:=oddnn: 

Redirects all I/O requests from one physical device unit to another (from 0 
to n). 

REMOVE (P) REM [ddnn:] taskname 

Deletes an entry (task name) from the System Task Directory (STD) and 
thereby removes the task from the system. The optional device specifica¬ 
tion indicates the device from which the task was installed. 

RESUME RES taskname 

Allows nonprivileged users to continue execution of a suspended task that 
was initiated from the entering terminal. Privileged users can resume any 
suspended task. 

RUN RUN taskname [/UIC=[g,m]] 

RUN taskname dtime [/RSI=magu][/UIC=[g,m]] (P) 

RUN taskname sync [dtime][/RSI=magu][/UIC=[g,m]] (P) 

RUN taskname atime (/RSI magu)[/UIC=[g,m|| (P) 

RUN [ddnn:][$] filespec (/keyword(s)] 

Keywords: CKP=option 

CMD="command-line" 

EST=option 

INC=size 

IOP=option 

PAR=pname 

PMD=option 

PRI=number (P) 

SLV=option 

TASK=taskname 

UIC=[g,m] 

Initiates execution of a task, either immediately or at one of several time- 
dependent intervals. 

SAVE (P) SAV (/keyword(s)] 

Keywords: WB 

MOU="string" 

SFILE="filespec" 

Copies the current system image into the system image file from which the 
current system was booted. 


75 



Monitor Console Routine (MCR) Commands 


SET SET /keyword=values 

Keywords: ABAUD[=TTnn:] 

BRO[=TTnn:] 

BUF=ddnn:[size] 

CLI=TTnn:[cli] 

COLOG 

CRT[=TTnn:] 

DCL[=TTnn:] 

EBC[=TTnn:] 

ECHO[=TTnn:] 

ESCSEQ[=TTnn:] 

FDX[=TTnn:] 

FORMFEED[=TTnn:] 

HFILL=TTnn:[value] 

HHT[=TTnn:] 

HOLD[=TTnn:] 

LINES=TTnn:[value] 

LOGON (P) 

LOWER[=ddnn:] 
MAIN=pname[:base:size:type] 
MAXEXT[=size] (P) 

MAXPKT[=n] 

MCR[=TTnn:] 

NETUIC[=[uic]] 

PLCTL[=high][:[low][:[frsiz][:basep]]] (P) 
POOL[=top] 

PRIV[=TTnn:] 

PUB[=ddnn:] 

REMOTE[=TTnn:[speed]] 

RNDC[=nn] 

RNDH[=nn] 

RNDL[=nn] 

RPA[=TTnn:] 

SLAVE[=TTnn:] 

SPEED=TTnn:[recv:xmit] 

SUB=mname:sname[:base:size] 

SWPC[=nn] 

SWPR[=nn] 

SYSUIC[=uic] 

TERM=TTnn:[value] 

TOP=pname:value 

TYPEAHEAD[=TTnn:] 

UIC[=[g,m][:TTnn:]] 

UIC[=TTnn:] 
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Keywords: VFILL[=TTnn:] 

WCHK[=ddnn:] 

WRAP[=TTnn:] 

Affects characteristics of the system, tasks, and devices. Privileged users 
can alter the characteristics of any device or task, but nonprivileged users 
can only alter characteristics for devices and tasks allocated to them. All 
users can display information. 

SYSTEM SERVICE MESSAGE (P) SSM message 

Inserts text into the error log file. 

TASKLIST - ATL TAL [tasknamel 

Displays the names and status of all tasks installed in the system or of a 
specific task. 

TASKLIST TAS |taskname][/DEV=ddnn:] 

Describes each task installed in the system, a specific task, or one or more 
tasks installed from a specific device. 

TIME TIM [hrs:mins[:secs]] [ml/day/yearl 
|hrs:mins|:secsj| [day-m2-year| 

For privileged users, sets and displays the date and time for the system. 
For nonprivileged users, only displays them. 

USER FILE DIRECTORY UFD ddnn:[volume-label][g,ml(/keyword(s)] 

Keywords: ALLOC=number 

PRO=[system, owner, group, world] 

Creates a User File Directory (UFD) on a Files-11 volume and enters its 
name into the Master File Directory (MFD). Privileged users can create 
UFDs on any mounted volume, but nonprivileged users can create UFDs 
only on a volume mounted on a device that they have allocated. 

UNBLOCK UNB |taskname] 

Continues the execution of a previously blocked task. Nonprivileged users 
can unblock only tasks running from their own terminals. Privileged users 
can unblock any task. 

UNFIX UNF taskname (P) 

Frees a fixed task from memory. 
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UNLOAD UNL dd: (P) 

Removes a loadable device driver from memory. 

UNSfTOP] taskname 

Continues execution of a task previously stopped internally by the Execu¬ 
tive. Nonprivileged users can unstop only tasks running from their own 
terminals. Privileged users can unstop any task. 
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In this section, (P) indicates that a command format or keyword is privileged. 


ABORT ABORT[/COMMAND][/qualifier[s]] commandname 
ABORT/TASK[/qualifier] taskname 

Command 

Qualifiers: /COMMAND 
/TASK 

/[NO]POSTMORTEM 
Default: /COMMAND 

Forces an orderly end to a running task or to the action of a specific 
command. 

ALLOCATE ALLOCATE[/qualifier[s]] dd[nn:] [logicalname] 

Command 

Qualifiers: /TERMINALrttnn: (P) 

/TYPE:devicetype 

Default: NONE 

Declares a specified device to be a private device. You can allocate devices 
by logical name or physical name. If you omit the unit number and colon, 
the first available device of that class is allocated. 

APPEND APPENDl/qualifier[s]] infile[,s] outfile 
Command 

Qualifiers: /DATE:dd-mmm-yy 
/SINCE:dd-mmm-yy 
/THROUGH:dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 
/TODAY 

/EXCLUDE:filespec 
Default: NONE 

Appends to an existing sequential file records from one or more sequential 
files. The file specification for the EXCLUDE qualifier can include wild¬ 
cards. Data range qualifiers, together with the /EXCLUDE qualifier, 
are also accepted on the COPY, DELETE, DIRECTORY, PURGE, 
RENAME, SET PROTECTION, TYPE, and UNLOCK commands. 
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ASSIGN ASSIGN[/qualifier[s]] ddnn: logical ddnn: 

Command 

Qualifiers: /LOCAL 

/LOGIN (P) 

/GLOBAL (P) 

/SYSTEM (P) 

/TERMINAL:ttnn: (P) 

Default: /LOCAL 

Associates a logical name with a physical device, pseudo device, or other 
logical device. All references to the logical name are resolved by the system 
to the associated physical device, pseudo device, or logical device. 

ASSIGN/QUEUE (P) ASSIGN/QUEUE queuename processorname 

Establishes a path between a queue and a processor in the Queue Manager 
subsystem. 

ASSIGN/REDIRECT (P) ASSIGN/REDIRECT oldddnn: newddnn: 

Redirects output from one physical device to another. You can also redirect 
a physical device to a pseudo device, or vice versa. 

ASSIGN/TASK (P) ASSIGN/TASK:taskname ddnn: lun 

Reassigns an installed task’s Logical Unit Numbers (LUNs) from one phys¬ 
ical device to another. The reassignment overrides the static LUN assign¬ 
ments in the task’s disk image file. You cannot change the LUNs of an 
active task. 

BACKUP BACKUP[qualifier[s]] source:[filespec[sl|dest: 

Command Qualifiers: 

Group 1: Selective Backup and Restore 

/AFTER:(dd-mmm-yy hh:mm) Use with /CREATED or with 

/BEFORE:(dd-mmm-yy hh:mm) /MODIFIED. 

/CREATED 

/EXCLUDE 

/IMAGE:arg 

SAVE 

RESTORE 

/MODIFIED 

/NEW_VERSION 

/[NOJREPLACE 
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Command Qualifiers: 

Group 2: Initialization 

/ACCESSED:n 

/BADBLOCKSrarg 

AUTOMATIC 

MANUAL 

OVERRIDE 

/EXTENSIONS 

/FILE_PROTECTION:code 

/HEADERS:n 

/INDEX:arg 

BEGINNING 

MIDDLE 

END 

n 

/[NOJINITIALIZE 

/MAXIMUM_FILES:n 

/WINDOWSs 


n is default number of FCBs on 
each volume 


default n=5 

default is same protection as input 
volume 

Specifies location of INDEXF.SYS 
on volume; default is same posi¬ 
tion as involume 

Logical block n 


default is same number of map¬ 
ping pointers (windows) as input 
volume 


Group 3: Tape and Disk Control 

/APPEND 
/SAVE_SET:name 

/DENSITY:arg 

800 

1600 

6250 

/ERROR_LIMITS 

/LABEL:TAPE:volumelabel 

/LENGTHS 

/REWIND 


Default is name of disk volume 
being backed up 

Default density = 800 bpi (if unit 
supports two densities; otherwise 
default is density of the particular 
unit.) 

Default n = 25 

Default n = physical length of the 
output tape 

Rewinds first tape of tape set be¬ 
fore executing the command line; 
may use with /APPEND 
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Command Qualifiers: 

Group 4: Verification 

/COMPARE 

/VERIFY 

Group 5: Display 
/LIST 

/[NOJLOG /LOG goes to Tl:; default is 

/NOLOG 

Group 6: Disk Processing 

/DIRECTORY 

/LABELarg 

INPUT:volumelabel 

[OUTPUT:]volumelabel /LABEL:OUTPUT is default; if the 

only volumelabel in command line 

is outvolume, /LABEL;volumelabel 
will do 

/MOUNTED 

/[NOJPRESERVE Default /PRESERVE 

Backs up and restores Files-11 volumes. It transfers files from a volume to a 
backup volume and retrieves files from the backup volume. BACKUP 
works through the Backup and Restore Utility (BRU). 

BASIC BASIC[/qualifier] 

Command 

Qualifiers: /B11 (BASIC-11) 

/BP2 (BASIC-PLUS-2) 

/USING:userbasic 

Invokes an interpreter or compiler for the BASIC language, if present. The 
default is BASIC-PLUS-2. 

BROADCAST BROADCAST ttnn: message 
BROADCAST @indlrectspec 
BROADCAST[/qualifier] message 

Command 

Qualifiers: /ALL (P) 

/LOGGED_IN (P) 

Displays the specified message at one or more terminals. 
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CANCEL CANCEL taskname 

Eliminates entries from the clock queue. CANCEL does not affect a cur¬ 
rently executing task, but only the pending entries in the clock queue. 


COBOL-81 COBOL[/qualifier[s]] filespec 
Command Qualifiers: 


/[NO] ANSI_FORMAT 

/[NO]CHECK:arg 

[NO]BOUNDS 

[NO]PERFORM 

ALL 

NONE 

/CODE:[NO]CIS 

/[NOJCROSS_REFERENCE 

/[NO]DEBUG 

/[NO]DIAGNOSTICS[:filespec] 

/[NOJLIST 

/NAMES:xx 

/[NOJOBJECT 

/[NOJOVERLAY_DESCRIPTION 

/[NO]SHOW:[NO]MAP 

/[NO]SKELETON 

/[NO]SUBPROGRAM 


Source in conventional 
format 

Default is CHECK 


Use CIS in object code 

Default is NODEBUG 

Default is NODIAGNOSTICS 

Default is NOLIST 

Use 2 characters to specify 

PSECT kernel 

Default is object 

Default is NOOVERLAY_ 

DESCRIPTION 
Default is NOSHOW 
Default is SKELETON 
Default is NOSUBPROGRAM 
Store temporary work files 
Default is COBOL-81 
Default is WARNINGS 


/TEMPORARY:device 

/USING:usercompiler 

/[NO]WARNINGS:[NO]INFORMATIONAL 

Invokes COBOL-81 compiler, if present. 


COBOL/Cl 1 COBOL!/qualifierfsl] filespec 

Command Qualifiers: 


/[NO]LIST[:filespec] 

/[NO]OBJECT[:filespec] 

/[NOJANSI_FORMAT 

/[NOjCHECK 

/[NO]CM6 

/[NOJCROSS_REFERENCE 

/LARGE—SYMBOI_TABLE[:n] 

/NAMES:xx 


Default is NOLIST 
Default is OBJECT 
Source in conventional format 
No bounds checking 
No COMPUTATIONAL-6 

Default n=1; 

2-character kernel (xx) for program 
section names. 
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Command Qualifiers: 

/NEST:n 

/[NO]OVERLAY 

/[NO]POOI_LITERALS 

/[NO] READ_ONLY 

/[NO]SHOW:(arg[,s]) 

COPY_LIST 

MAP 

VERB_LOCATION 

/[NOJSKELETON 

/[NOJSUBPROGRAM 

/TEMP:ddnn: 

/WARNINGS 

/NOWARNINGS 


Depth of nested performs; default 
n=10 


Default is NOREAD_ONLY 

Specifies additions to listings 
Source satements from library 
Special map 

Location of each program verb 
Create .SKL file 

Treat source file as subprogram 
Store temporary work files 
Warning and fatal diagnostics 
printed 

Only fatal diagnostics printed 


Invokes the PDP-11 COBOL (COBOL/Cll) compiler, if present. 


CONTINUE CONTINUE[/qualifier] [taskname] 

CONTINUE resumes execution of a previously suspended task. Taskname 
defaults to TTnn. 


CONVERT CONVERT[/qualifier[s] infile outfile 


Command 

Qualifiers: 

/[NOJAPPEND 



/BLOCK_SIZE:n 

Default is 512 


/[NOJFIXED_CONTROL 

Default is NOFIXED_ 


/[NOJIDENTIFICATION 

CONTROL 

Default is NOIDENTIFICATION 


/INDEXED 

Outfile is indexed 


/KEY[:n] 

defaults 


/[NO]LOG_FILE[:filespec] 

NOLOG—FILE is default. 


/[NO] MASS_INSERT 

/MERGE 

/PAD[:[#]arg] 

Pad infile records to outfile 


/RELATIVE 

/[NOJREPLACE 

/SEQUENTIAL 

/[NOJTRUNCATE 

length. Default pad character 
is blank. 

Default is NOTRUNCATE 

Invokes the 

RMSCNV utility which moves records from one file to another. 
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RMSCNV reads records from an input file and writes them to an output 
file. The action of RMSCNV depends on the organization - sequential, 
relative, or indexed — of the two files, and on the qualifiers you include in 
the CONVERT command. See the main text and the RMS-11 documenta¬ 
tion supplied with your system for more information. 

COPY COPY infile|s) outfile[s| 

Command 

Qualifiers: /BLOCK _SIZE:n n is octal unless terminated 


with decimal point 


/[NO] CONTIGUOUS 
/OWN 


Makes outfile UIC owner 
of copy 


/REPLACE 

/[NO]SPAN_BLOCKS 


Copies files. Unless specified otherwise, COPY preserves the file organiza¬ 
tion of the input file: that is, indexed files are copied as indexed files, and 
so forth. See also the CONVERT command. See APPEND command de¬ 
scription for other qualifiers. 


CORAL 66 CORAL[/qualifier|s| filespec[,s| 
Command Qualifiers: 


/[NOJCHECK 

/CODE:arg Choose instruction 


Default is /NOCHECK 
set 

Extended instruction set 
Floating point instruction set 
Floating point processor 
Position-independent 

Default is EXTEND_SOURCE 

Default is NOLIST 

Default is NOMACHINE_CODE 


EIS 

FIS 

FPP 

PIC 


/[NO] EXTEND_SOURCE 

/[NO]LIST[:filespec] 

/[NO] MACHINE_CODE 

/NAMES:xx 
/[NO]OBJECT 
/[NO] OPTIMIZER LEVEL:n] 
/READ_ONLY[:arg] 


Default is OBJECT 

Default is OPTIMIZE 

Alter READ_ONLY or READ/WRITE 


attribute 

ALL 

NONE 

PURE_DATA 


Default is PURE_DATA 
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Command Qualifiers: 

/[NO]SHOW[:(arg[,s])] 

ALL 

EXPANSIONS 

NONE 

OVERRIDE 

SOURCE 

STATISTICS 

SYMBOLS 

/[NOJSTANDARD 

/TEST[:n] 

/[NOJTRACEBACK 

/WIDTH:n 


Default is SHOW STATISTICS 

Default is NOSTANDARD 
Default is TEST:0 
Default is NOTRACEBACK 
Default is WIDTH:132 


CREATE CREATE filespec 

Creates a sequential file in a directory on a file-structured device. After you 
issue the CREATE command, you can immediately enter text. If you want 
an empty file, enter a CTRL/Z. 


CREATE/DIRECTORY CREATE/DI RECTOR Y[/qualifierl [dclnn:] [g,m] 
Command 

Qualifiers: /ALLOCATIONS 

Entries for n files 

/PROTECTION:code 

/LABEL:volumelabel 

Creates a User File Directory (UFD) on a Files-11 volume and enters its 
name in the volume’s Master File Directory (MFD). Nonprivileged users 
can create directories on mounted volumes only on their own private (allo¬ 
cated) devices. 

DEALLOCATE DEALLOCATE[/qualifier] [ddnn:] 

Command 

Qualifiers: /ALL Frees all devices 

allocated by Tl 

/DEVICE 

Counteracts ALLOCATE and frees a private device for access by others. 

DEASSIGN DEASSIGN[/qualifier[s]] logicalddnn: 

Command 

Qualifiers: /ALL Combine with any other qualifier 

/LOCAL Default 
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Command 
Qualifiers: /LOGIN 

/GLOBAL (P) 

/SYSTEM (P) Synonym for global 

/TERMINAL:ttnn: (P) 

Deletes logical-device assignments. DEASSIGN disassociates logical 
names from physical device names, pseudo device names, or logical device 
names created by ASSIGN. 

DEASSIGN/QUEUE (P) DEASSIGN/QUEUE queuename processorname 

Counteracts ASSIGN/QUEUE. It is used to eliminate the path from a 
queue to a processor in the Queue Manager subsystem. 

DELETE DELETE[/qualifler[s]] 

Command 

Qualifiers: /[NO]LOG Lists deleted files on Tl: 

/[NOJQUERY 

Deletes specified versions of files and releases the storage space that the 
files occupy. See APPEND command description for other qualifiers. 

DELETE/ENTRY DELETE/ENTRY:n[/qualifier] 

Command 

Qualifier: /FILE_POSITION:n 
Deletes QMG jobs by entry number. 

DELETE/JOB DELETE/JOB[/qualifier] queuename [[g,m]]jobname 

Command 

Qualifier: /FILE_POSITION:n 

Deletes QMG jobs by queue name and job name. 


DELETE/PROCESSOR (P) DELETE/qualiflers processorname 


Qualifiers: APPLICATIONS—PROCESSOR 

BATCH_PROCESSOR 

CARD_READER 

DEVICE 

INPUT 

PRINTER 

PROCESSOR 


Synonym for input 
Synonym for printer 
Synonym for cardreader 
Synonym for device 


Deletes print processors, output despoolers, or batch processors from the 
Queue Manager subsystem by processor name or device name. This com¬ 
mand also sets the device unspooled. 
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DELETE/QUEUE (P) DELETE/QUEUE queuename/ERASE 

Deletes queues in the Queue Manager subsystem by name. See DE¬ 
LETE/JOB and DELETE/ENTRY to delete jobs from queues. 


DIFFERENCES DIFFERENCES infilel infile2 


Command 

Qualifiers: 


/CHANGE_BAR[:n] 


/IGNORE:arg 

BLANK__LINES 

COMMENTS 

FORM_FEEDS 

SPACING 

TRAILING_BLANKS 

/LINES:n 

/[NO]NUMBERS 

/OUTPUT:filespec 

/SLP[:audittrail] 


n is alternative octal 
ASCII code of change- 
bar character. 

Default is 041 (1) 


Comments begin with 

any group of tabs and 
blanks equals one blank 

The n lines specified must 
be the same for a match. 
Line numbers in output 
file 

Names output file; Tl: is 
default. 


Compares two ASCII (text) files line by line to determine if parallel records 
(lines) are identical, and produces a listing of the differences, if any, be¬ 
tween the files. 


DIRECTORY DIRECTORY|/format][/destination|[otherqual[s|][filespec[s]] 


Command 

Qualifiers: 

Format 



/ATTRIBUTES 

RMS-11 attributes 


/BRIEF 

/FREE [ddnn:] 

Free blocks on volume; 


/FULL 

/SUMMARY 

default volume is SY: 

Blocks used and allocated 


Destination 

/OUTPUT[:filespec] 

Names output file; Tl: is default 


/PRINTER 

Output to printer 
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Command 

Qualifiers: Other qualifiers 

/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/THROUGH:dd-mmm-yy 

/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 

/TODAY 

/EXCLUDE:filespec Filespec can include wildcards 

Displays information on files in directories (UFDs). See APPEND com¬ 
mand description for other qualifiers. 


DISMOUNT DISMOUNT ddnn: [label] 

Command 

Qualifiers: /ALL Dismount all devices mounted 

by user 

/PUBLIC (P) Dismount all users 

from volume 

/SYSTEM Synonym for /PUBLIC 

Marks the volume mounted on the specified device as logically off line and 
disconnected from the file system. 


EDIT EDIT[/qualifier] [edit-input] 


Command 
Qualifier: /EDI 
/KED 
/K52 
/MAKE 
/MUNG 

/OUTPUT:filespec 

/CREATE 

/SOS 

/TECO 

/USING:yyy 


Line text editor 
Unbundled KED editor 
VT52 version of KED 
Unsupported TECO function 
Unsupported TECO function 
Use with KED and K52 
Use with KED and K52 
Unsupported Son of Stopgap 
Unsupported Text Editor and 
Corrector 

Unsupported user editor 


Invokes an editor. See also EDIT/EDT and EDIT/SLP for those editors 


EDIT/EDT EDIT/EDT|/qualifier!s]| filespec 

EDIT[/qualifier[s]] filespec 

Command 

Qualifiers: /[NO]COMMAND[:filespec] Default is /COMMAND: 

EDTINI.EDT 
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Command 

Qualifiers: /[NO]JOURNAL[:filespec] 

/[NO]OUTPUT[:filespec] 

/[NO]READ—ONLY Default is /NOREAD ONLY 

/[NO]RECOVER Default is /NORECOVER 

Invokes EDT, the DEC Standard Editor and the default editor. 

EDIT/SLP EDIT/SLP[/qualifier[s] filespec 


Command 

Qualifiers: 

/[NO] AUDIT[:(arg[s])] 

Default is /AUDIT: 
(POS:80:512Z:8) 


POSITIONS 

n<=132. 


SIZE:n 

n<=14. 


/CHECKSUM[:n] 

/[NO]LIST[:filespec] 

/[NO]OUTPUT[:filespec] 

/[NOJREPORT 

Report truncation lines 
by audit trail 


/[NO]TAB 

Right-justify with tabs 
or spaces. Default is NOTAB 


/[NO]TRUNCATE[:n] 

Deletes audit trails and 
trailing characters 


Invokes the Source Language Input Program (SLP), a program-mainte¬ 
nance editor. 


FIX (P) FIX taskname 

Causes an installed task or region to be loaded and locked into memory. 


FORTRAN FORTRAN[/qualifier[s]] filespec[s] 


Command 

Qualifiers: 


/[NOJCHECK 

/CODE:arg 

EAE 

EIS 

FIS 

THREADED 

/CONTINUATIONS^ 

/[NOJDLINES 

/[NO] EXTEND_SOURCE 


F4P and F77 

FOR; arguments are mutually 
exclusive 


F4P and F77; n=0-99 
continuation lines 
Compile D-lines 


FOR; accepts 72 columns 


/FOR FORTRAN-IV 
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Command 
Qualifiers: /F4P 

/[NO]F77 

/IDENTIFICATION 

/[N0]I4 

/[NOJLINE_NUMBERS 

/[NO]LIST[:filespec] 

/MACHINE_CODE 

/MAP 

/[NO]OBJECT[:filespec] 

/[NO]SHAREABLE 

/SOURCE 

/[NO]STANDARD:arg 

ALL 

NONE 

SOURCE 

SYNTAX 

/[NO]TRACEBACK:arg 

ALL 

BLOCKS 

LINES 

NAMES 

NONE 

/USING:usercompiler 
/[NO]VECTORS 
/[NO]WARNINGS 
/WORK_FILESrn 


Invokes a FORTRAN compiler, if 


FORTRAN-1 V-PLUS 
FORTRAN-77; /NOF77 is 
FORTRAN-1 V-PLUS 
Compiler and version number 
14 is 2-word variables; default is 
NOW 

Default is /NOLIST 


Default is /OBJECT 

F4P and F77. Multiuser task 

F77; default /NOSTANDARD 


F4P and F77 
Same as LINES 

Same as ALL 


FOR; default is /VECTORS 
FOR; default is /WARNINGS 
F4P and F77; n is maximum 
number of temporary files. 

mt. The default is FORTRAN-IV. 


HELP HELP[/qualifier[s]] [%] |parameter! | [...parameter^ 


Command 

Qualifiers: /OUTPUT:filespec 
/LOCAL 
/GROUP 
/CLkcliname 
/MCR 
/DCL 

/FILE:filespec 

/filename 


Default is /OUTPUTrTI: 

Help file is in default UFD; 

Help file is in [g,1 ]; g is 
your group number 
Default for MCR terminals 
Default for DCL terminals 
Names file containing help text 
Defaults to LB:[1,2]filename.HLP 


Displays information about your system. Help for MCR, DCL, and most 
utilities is supplied with the system. Your system may also have help for an 
alternate CLI, as well as local, group, or other special help. 
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HOLD/ENTRY HOLD/ENTRY:n 

Holds a QMG job in its queue by entry number. 


HOLD/JOB HOLD/JOB queuename ||g,m||jobname 

Holds a QMG job in its queue by queue name and job name. 

INITIALIZE INITIALIZE[/qualifier[s]] ddnn: volumelabel 


Command 

Qualifiers: /ACCESSED:n Number of UFDs accessed 

simultaneously 

/BAD_BLOCKS:arg 

AUTOMATIC 

MANUAL 

OVERRIDE 

/DENSITY:arg 

800 

1600 

6250 

/EXTENSIONS Extend files by n blocks; 

default n=5. 

/FILE_PROTECTION:(code) 

/HEADERSin 


/INDEX:arg Locates index file on volume 

BEGINNING Default for tapes & DEC tapes 

MIDDLE Default for disks 

END 


n 

/MAXIMUM_FILES:n 

/[NOJSHOW 

/OWNER:[g,mJ 

/PROTECTION:code 

/[NOJLOG 

/WINDOWS:n 


Logical block n 

Default is NOSHOW 
Specifies owner of volume 

Displays volume information 
Default n=7. 


Produces a volume in Files-11 format. See also INITIALIZE/UPDATE. 
You can mount the volume /FOREIGN on RSX-11M, but it is not re¬ 
quired. Nonprivileged users must allocate the device. 
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INITIALIZE PROCESSOR INITIALIZE/quallfiers 

processorname/parameter qualifier 

Command 

Qualifiers: PROCESSOR 

CARD_READER 

INPUT 

Parameter 

Qualifiers: /BATCH_QUEUE:queuename 

/CONSOLE:ddnn: 

/PRINTER_QUEUE:queuename 

INITIALIZE/QUEUE INITIALIZE/QUEUE queuename 
Command 

Qualifiers: /BATCH 
/PRINTER 

/QUEUE/[NO]WARNING 

INITIALIZE/QUEUE creates, names, and starts a queue in the Queue 
Manager subsystem. 

INITIALIZE/UPDATE INITIALIZE/UPDATE[/qualifier[s]] ddnn: 
volumelabel 

Command 

Qualifiers: /ACCESSED:n 
/DENSITY:arg 
800 
1600 
6250 

/EXTENSIONS Extend full files by n 

blocks 

/FILE_PROTECTION:code 

/OWNER:[g,m] 

/MAXIMUM_FILESrn 

/PROTECTION:code 

/[NOJSHOW Default is NOSHOW 

/VOLUME_LABEL:newvolumelabel 

/WINDOWS:n Mapping pointers to file 

windows; default is 7. 

Invokes the HOME utility to alter values in the Volume Home Block 
without affecting the other data on the volume. INITIALIZE/UPDATE is 
only for disks and DECtapes in Files-11 format. You can mount the vol¬ 
ume /FOREIGN, but it is not required. 
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INSTALL INSTALL[/qualifier[s]] [$]filespec (P) 

Command 

Qualifiers: /[NOJCHECKPOINT 

/COMMAND:“taskcommand” 

/EXTENSIONS n (octal) additional 

words of address 
space 

/MULTIUSER—PARTITION:parname Read only portion 

/PARTITION:parname 

/[NO]POSTMORTEM 

/PRIORITY:n 0-250 

/READONLY_COMMON 

/[NO]SLAVE Default is /NOSLAVE 

/TASK_NAME:taskname 1-6 characters 

/UIC:[g,m] 

Includes a task in the System Task Directory, thus making it known to the 
system. 


LIBRARY LIBRARY[/operation][/qualifier[s]] 

LIBRARY @filespec 

Creates and maintains user-written library files. The command has eight 
functions, each listed here as a separate command. See main text for more 
details on all functions and qualifiers. 


LIBRARY/COMPRESS LIBRARY/COMPRESS|:(arg|,s])] lib[newlib] 

Arguments: GLOBALrn Entry point table entries 

MODULES:n Module name table entries 

BLOCKS:n Size in 256-word blocks. 

Physically deletes modules that have been logically deleted through 
LIBRARY/DELETE. You can rename the resulting compressed library. 
You can also use this command to copy a library and rename it. 


LIBRARY/CREATE LIBRARY/CREATE[:(arg[,sl)][/quallfier[s]llb[lnflle[s]] 


Arguments: GLOBALrn 
MODULES:n 
BLOCKS:n 


Entry point table entries 
Module name table entries 
Size in 256-word blocks 


Command 

Qualifiers: /[NOJGLOBALS 
/MACRO 

/OBJECT Identifies object library; default 
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Command 

Qualifiers: /SELECTIVE_SEARCH 

/SQUEEZE 

/UNIVERSAL 

Creates a library and optionally inserts one or more modules into it. 

LIBRARY/DELETE LIBRARY/DELETE libspec module[,module[,s] 

Deletes object modules from a library. See LIBRARY/REMOVE for remov¬ 
ing global symbols (entry points) from a library. 

LIBRARY/EXTRACT LIBRARY/EXTRACT[/qualifier] libspec module[,s] 

Command 

Qualifier: /OUTPUT[:filespec] 

Reads one or more modules from a library and writes them to a specified 
output file. You can extract up to eight modules with a single command. If 
you extract more than one module, the modules are concatenated in the 
output file. Default output file is TI: 

LIBRARY/INSERT LIBRARY/INSERT libspec filespec[s] 

Command 

Qualifiers: /[NOJGLOBALS 

/SELECTIVE-SEARCH 

/SQUEEZE 

Inserts modules from one or more files into a library. 

LIBRARY/LIST LIBRARY/LIST[:filespec] libspec 

Command 
Qualifiers: /BRIEF 
/FULL 

/[NOJNAMES Names and global entry points 

Lists the names of all modules in a library on your terminal or in an output 
file. 

LIBRARY/REMOVE LIBRARY/REMOVE libspec global[,global[,s] 

Removes global symbols (entry points) from a library. See LIBRARY/DE¬ 
LETE for deleting object modules from a library. 
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LIBRARY/REPLACE LIBRARY/REPLACE libspec filespec[sl 

Command 

Qualifiers: /[NO]GLOBALS 

/SELECTIVE_SEARCH 

/SQUEEZE 

Replaces a module in a library with a new modules of the same name and 
deletes the old module. 

LINK LINKf/qualifierfs]| filespec[/qualifierfs]][,filespec[s]] 

Command 

Qualifiers: /ANCILLARY_PROCESSOR[:n] 

/BASIC 

/[NO]CHECKPOINT:arg 


SYSTEM 

Checkpoints to [1,2] 
CORIMG.SYS 

TASK 

Checkpoints to task 
image file 

/CODE:(arg[s]) 


EAE 


FPP 


PIC 

Same as POSITION- 


INDEPENDENT 

POSITION—INDEPENDENT Same as PIC 
/COMPATIBLE 

/[NOJCROSS_REFERENCE 

/[NO]DEBUG[:filespec] Default is ODT 

/[NO]EXECUTABLE:filespec Same as /TASK 

/ERROR—LIMIT:n Stops task build after n 

errors 

/FAST 

/FULI_SEARCH 

/[NO]HEADER 
/IO_PAGE 

/LONG Long map 

/MAP[:filespec] 

/[NO]MEMORY—MANAGEMENT[:n] Default is MEM 
/OPTIONS 

/OVERLAY_DESCRIPTION 

/POSTMORTEM 

/[NOJPRIVILEGED Default is NOPRIV 

/[NOJRECEIVE 

/[NO] RESIDENT_OVERLAYS 

/SAVE Saves indirect file 
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Command 

Qualifiers: 


/SELECTIVE_SEARCH 

/[NO]SEGREGATE 

/SEQUENTIAL 

/SHAREABLE[:arg] 

COMMON 

LIBRARY 

TASK 


Default is NOSEG 

Multiuser task; default 
argument is TASK 


/SLAVE 

/SLOW 

/SYMBOI_TABLE[:filespec] 

/[NO]SYSTEM_LIBRARY_DISPLAY Default is NOSYS 

/[NO]TASK[:filespec] Same as /EXECUTABLE 

/TKB Default is TKB 

/TRACE 

/[NO]WARNINGS Default is WARNINGS 

/WIDE 


File 

Qualifiers: /[NOJCONCATENATE 

/DEFAULT-LIBRARY Names file to replace 

[1,1] SYSLIB.OLB 

/[NOJGLOBALS Default is /GLOBALS 

/LIBRARY 

/INCLUDE:(module1 ....modulen) 

/OVERLAY_DESCRIPTION 

/SELECTIVE_SEARCH 

Invokes the Task Builder, which links object modules and routines from 
user and system libraries to form an executable task. See also LINK/C81. 


LINK/C81 LINK/C81 [/qualifiers]] filespec[,s] 

LINK/COBOL[/qualifier[s]] filespec[,s] 


Command 

Qualifiers: /[NOJFMS Default is NOFMS 

/FMS:NORESIDENT Equivalent to /FMS 

/OTS:[NO]RESIDENT Default is OTS:NORESIDENT 

/[NO]MAP Default is NOMAP 

/[NO]RMS:[NO]RESIDENT 

/[NOJDEBUG Default is NODEBUG 


Invokes the Task Builder, which links COBOL-81 object files to produce a 
task image. (.TSK file). 
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LOGIN LOGIN userid password 

Grants access to a multiuser protection system and establishes your privi¬ 
leges as a system user. 

LOGOUT LOGOUTf/qualifier] 

Command 

Qualifier: /[NOJHOLD Holds remote line after 

logout; default is NOHOLD 

Counteracts LOGIN. LOGOUT also aborts any nonprivileged tasks run¬ 
ning from the terminal, and dismounts any volumes and deallocates any 
private devices allocated from the terminal. 

MCR MCR mcrcommand 

Enters an MCR command from a DCL terminal without leaving DCL. 

MACRO MACRO[/qualifier[s]] filespec[/qualifier[s]][,filespec[s]] 
Command 

Qualifiers: /[NOJCROSS—REFERENCE Default is NOCROSS 

/DISABLE:(parameter[,parameter[s]]) 

ABSOLUTE 

BINARY 

CARD_FORMAT 

GLOBAL 

LOCAL 

LOWER_CASE 

REGISTER—DEFINITIONS 
TRUNCATION 

/ENABLE:(parameter[,parameters]] 

ABSOLUTE 

BINARY 

CARD_FORMAT 

GLOBAL 

LOCAL 

LOWER_CASE 

REGISTER_DEFINITIONS 

TRUNCATION 

/[NO]LIST[:filespec] Default is NOLIST 

/[NO]OBJECT[:filespec] Default is OBJECT 
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Command 

Qualifiers: /[NO]SHOW[:(parameter[,parameter[s])] 
ALL 

BINARY 
CALLS 
COMMENTS 
CONDITIONALS 
CONTENTS 
COUNTER 
DEFINITIONS 
EXPANSIONS 
EXTENSIONS 
LISTING-DIRECTIVES 
OBJECT—BINARY 
SEQUENCE—NUMBERS 
SOURCE 
SYMBOLS 
/[NO]WIDE 


File 

Qualifiers: /LIBRARY File is macro library 

/PASS:n Assemble on pass 1 or 2 

Invokes the MACRO-11 Relocatable Assembler, which assembles one or 
more MACRO-11 source files into a single relocatable object module suit¬ 
able for processing by the Task Builder. 

MOUNT MOUNT[/qualifier[s]] ddnn: volumelabel 

(Disks and other random-addressable devices) 
MOUNT[/qualifier[s]] ddnn:|,ddnn:...| fileset-ID 
(magnetic tapes) 

Command Qualifiers for Both Disks and Tapes: 

/DEFAULT:arg 

SAVE 

NOUNLOAD 

UNLOAD 

/FILE—PROTECTION:(code) Protection for files created 

during mount 

/FOREIGN 

/OVERRIDE:IDENTIFICATION (P) 

/PARAMETERS:"user parameters" 

/PROCESSOR:arg 

acpname 

UNIQUE[:acpname] 
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Command Qualifiers for Both Disks and Tapes: 

/PROTECTION:(code) 

/PUBLIC (P) 

/[NOJSHAREABLE 
/[NOJLOG 
/SYSTEM 
/[NOJWAIT 
/[NOJWRITE 

Command Qualifiers for Disks and Other Files-11 Devices: 

/ACCESSED:n n is number of File Control Blocks 

/EXTENSIONS Extend full files by n blocks 

/OWNER:[uic] 

/UNLOCK 

/WINDOW:arg 

n 

(USER:n,INDEX:n) 


Deallocates and sets device public 
Displays volume information on Tl 
Default is /NOWAIT 


Command Qualifiers for ANSI and Unlabelled Tapes: 

/BLOCK_SIZE:n 

/CARRIAGE_CONTROL:arg 

FORTRAN 

LIST 

NONE 

/DENSITY:arg 

800 

1600 

6250 

/[NO]HDR3 

/[NOJLABEL 

/OVERRIDE:arg 

ACCESSIBILITY 

EXPIRATION_DATE 

SET_IDENTIFICATION 

/RECORD_SIZE:n 
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Command Qualifiers for ANSI and Unlabeiled Tapes: 


/TRANSLATE:arg 

EBCDIC 


NONE 

UT1 

UT2 

UT3 


/VOLUME_IDENTIFICATION:(volume-ID[,volume-ID[s]) 

Declares a volume to be logically known to the system, on line, and avail¬ 
able for use. Some qualifiers can be used with any MOUNT command; 
some are limited to mounting disks (and other random-addressable de¬ 
vices) and others are limited to mounting magnetic tapes. 

PRINT PRINTf/qualifierfs] filespec[/qualifier[s][,filespecfs]] 

Command 

Qualifiers: /AFTER:(dd-mmm-yy hh:mm) 


/COPIES:n 
/[NOJDELETE 
/DEVICE:ddnn: 
/[NOJFLAG_PAGE 


Flag page on each file; 
default is NOFLAG 
n can be 0 through 256; 
default is 0 
Default is NOHOLD 


/FORMS:n 


/[NOJHOLD 
/JOB—COUNT 
/[NO] JOB—PAGE 


Flag page on job; default 
is JOB.PAGE 


/LENGTH:n 


/[NO] LOWERCASE 

/NAME:jobname 

/[NO]TRANSFER 

/PAGE_COUNT :n 

/PRIORITY:n 


n is 1 through 150 nonprivileged 


1-9 characters 


1 through 250 privileged 
Default is 50 


/QUEUE:queuename 

/[NOJRESTART 

/[NOJUPPERCASE 
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File 

Qualifiers: /COPIES:n 

/[NOJDELETE 

/[NO]TRANSFER 

Queues files for printing on a line printer. PRINT can also queue jobs for 
other output devices. 

PURGE PURGE[/qualifier[s]] filespec[s] 

Command 

Qualifiers: /KEEP:n 

/[NOJLOG Lists files on Tl as deleted 

Deletes all but the latest versions of files, and releases the storage space 
that the deleted files occupy. See APPEND command description for other 
qualifiers. 

RELEASE/ENTRY RELEASE/ENTRY:n 

Releases by entry number a print or batch job that has been held in its 
queue. The variable n is the QMG entry number. 

RELEASE/JOB RELEASE/JOB queuename [[g,m]]jobname 

Releases by queue name and job name a print or batch job that has been 
held in its queue. 

REMOVE REMOVEr/qualifier] taskname 
Command 

Qualifier: /REGION (P) 

Counteracts INSTALL. REMOVE takes a task name out of the System 
Task Directory. Privileged. 

RENAME RENAME[/qualifier[s]] oldfilespec newfilespec 

Changes the name, type, or version number of an existing file. See 
APPEND command description for other qualifiers. 

REQUEST REQUEST message 

Sends a message to the operator’s console (CO:). 
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RUN uninstalledtask RUN[/qualifier|s]] |$|filespec 
Command 

Qualifiers: /[NOJCHECKPOINT 

/COMMAND:"taskcommand" 

/EXTENSIONS 
/PARTITION:parname 
/[NOJPOSTMORTEM 
/PRIORITY:n (P) 

/STATUS:arg 

TASK 

COMMAND 

/TASK_NAME:taskname 

/UIC:[g,m] (P) 

When used to run an uninstalled task from a task image file, RUN is a 
combination command, encompassing INSTALL, RUN, and REMOVE. 

RUN installedtask RUN[/qualifier[s]] taskname 
Command 

Qualifiers: /DELAY:nu (P) 

/INTERVAL:nu (P) 

/SCHEDULE:hh:mm:ss (P) 

/STATUS:arg 

COMMAND 
TASK 

/SYNCHRONIZE:u (P) 

/UIC:[g,m] (P) 

Initiates the execution of installed tasks. Privileged users can use RUN 
initiate the execution of installed tasks on a schedule by creating entries 
the sytem clock queue. 

SET [DAYJTIME (P) SET [DAY]TIME:[dd-mmm-yy] [hh:mm] 

Sets the system date and time. 

SET DEFAULT SET DEFAULT[:ddnn:] [[g,m]] 

Establishes your default device or UFD, or both. With no arguments, SET 
DEFAULT returns a nonprivileged user to login device and UIC. 
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SET DEVICE (P) SET DEVICE:ddnn:/qualifier[s] 

Command 

Qualifiers: /[NO]CHECKPOINT_FILE[:n] n is number of deci¬ 

mal blocks 
in [0,0] CORIMG.SYS 

/[NO] LOWERCASE 

/[NOJPUBLIC Default is NOPUBLIC 

/WIDTH:n (Nonprivileged for Tl:) 

Establishes certain device attributes. 

SET GROUPFLAGS SET GROUPFLAGS:n[/qualifierl 

Command 

Qualifiers: /CREATE Default is CREATE 

/DELETE 

Creates and deletes group global event flags. Nonprivileged users can use 
the command for their own group. The variable n is the group number. 

SET [NOJPARTITION (P) SET [N01PARTITI0N:parname/quallfier[s] 

Command 

Qualifiers: /BASE:n 

/DEVICE Device common 

/SIZEin 

/SUBPARTITION 

/SYSTEM 

/TASK 

/TOP 

Creates or eliminates a partition. 

SET PRIORITY (P) SET PRIORITY:n. taskname 

Alters the priority of an active task. 

SET PROTECTION SET PROTECTION:code [/qualifierfsl] filespec[sl 

Establishes the protection status of files. Default is SY:RWED, 
OW:RWED,GR:RWED,W:R. See APPEND command description for 
other qualifiers. 

SET QUEUE/ENTRY SET QUEUE/ENTRY:n[/qualifier] 

Command 

Qualifiers: /AFTER:(dd-mmm-yy hh:mm) 

/COPIES:n 
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Command 

Qualifiers: /[NO]DELETE 

/FILE_POSITIONS 

/FORMS:n 

/HOLD Same as HOLD/QUEUE 

/LENGTH:n 

/[NO] LOWERCASE 

/PAGE_COUNT :n 

/PRIORITY:n n is 1 through 150 nonprivileged; 

1 through 250 privileged 
Default is 50. 

/RELEASE Same as RELEASE/QUEUE 

/[NO]RESTART 

/[NO] UPPERCASE 

Modifies by entry number some attributes of print or batch jobs once they 
are in a queue. See SET QUEUE/JOB to modify by job name. 

SET QUEUE/JOB SET QUEUE/JOB[/qualifier| queue ||g,m||jobname 
Command 

Qualifiers: /AFTER:(ddd-mmm-yy hh:mm) 

/COPIES:n 

/[NO]DELETE 

/FILE_POSITION :n 

/FORMSrn 
/HOLD 
/LENGTH:n 
/[NO] LOWERCASE 

/PAGE_COUNT :n 

/PRIORITYin 


/RELEASE 
/[NO]RESTART 
/[NO] UPPERCASE 

Modifies by job name some attributes of print or batch jobs once they are 
in a queue. See previous command to modify by entry number. 


Same as HOLD/QUEUE 


n is 1 through 150 nonprivileged; 

1 through 250 privileged 
Default is 50. 

Same as RELEASE/QUEUE 


SET SYSTEM (P) SET SYSTEM/qualifler 
Command 

Qualifiers: /DIRECTORY:[g,m] Sets UFD where system tasks 

are kept 

/EXTENSION LIMIT:n Maximum size a task can be 
extended 
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Command 

Qualifiers: /[NO]LOGINS 

/PACKETS:n n is 0 through 15 

/POOL:top:max:total Increases pool size 

Establishes certain characteristics of the system. 

SET TERMINAL SET TERMINAL[:ttnn:]/qualifier[s] 

Command 
Qualifiers: 

Group 1: Common Use 
/DCL 

/[NOJHOLD_SCREEN 

/[NO] LOWERCASE 
/MCR 

/PAGE—LENGTH:n 
/[NOJPRIVILEGED (P) 

/SPEED:(transmit,receive) 

/[NO] UPPERCASE 
/WIDTH.n 

Group 2: Terminal Setup 

/ASR33 
/ASR35 

/CRFILL:n n is 0 through 7. 

/[NO]FORM_FEED 

/[NOJHARDCOPY 
/KSR33 
/LA30P 
/LA30S 
/LA36 
/LAI20 
/LAI80S 
/LFFILL 
/[NOJSCOPE 
/[NO]TAB 
/MODEL:arg 
/VT05 
/VT50 
/VT52 
/VT55 
/VT61 
/VT100 


NOLOWER is default. Same as UPPER 
Default is terminal hardware setting 

Same as LOWER 
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Command 

Qualifiers: 

Group 3: Task Setup 

/[NOJECHO 

/[NO]EIGHT_BIT 

/[NO]ESCAPE 

/[NO]FULI_DUPLEX 

/[NO]INTERACTIVE 

/[NOJLOCAL 

/[NOJPASSALL 

/[NO]REMOTE 

/[NO]TYPE_AHEAD 

/[NO]WRAP 

SET TERMINAL sets various attributes of your terminal. Privileged users 
can set attributes for any terminal. 

SHOW ASSIGNMENTS SHOW ASSIGNMENTS[:ttnn:]/qualifier 
Command 

Qualifiers: /GLOBAL (P) 

/LOCAL Default is LOCAL 

/LOGIN (P) 

/SYSTEM (P) Same as /GLOBAL 

Displays at your terminal all local and login logical-device assignments. 
Privileged users can display assignments from other terminals and global 
assignments. 

SHOW CLOCK_QUEUE SHOW CLOCK_QUEUE 

Displays information about tasks currently in the clock queue. This infor¬ 
mation consists of the task names, the next time each task is to be run, and 
each task’s reschedule interval, if any. 

SHOW [DAYJTIME SHOW [DAYJTIME 

Displays the system time and date setting. 

SHOW DEFAULT SHOW DEFAULT 

Displays the current default device and UFD for your terminal, along with 
your terminal number. 
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SHOW DEVICES SHOW DEVICES|:dd||/qualifierJ 

Command 

Qualifiers: /[NOJPUBLIC 
/WIDTH 

Displays information about the devices included in the system. 

SHOW GROUPFLAGS SHOW GROUPFLAGS 

Displays the group global event flags currently in the system. 

SHOW MEMORY SHOW MEMORY 

Invokes the Resource Monitoring Display (RMDEMO), a dynamic display 
of the system’s activities in memory. 

SHOW PARTITIONS SHOW PARTITIONS! :name| 

Displays address and content information about the partitions in the sys¬ 
tem. You can display information about all partitions or about a single 
partition. 


SHOW PROCESSOR SHOW PROCESSOR|PROCESSORNAME|argl| 

Arguments: CARD_READER Same as INPUT 

DEVICE Output processor; same as printer 

INPUT Same as CARD_READER 

PRINTER Same as DEVICE 

Displays information about the batch processors, printers, card readers, 
and other devices under control ot the Queue Manager. 


SHOW QUEUE SHOW QUEUE|/qualifier| |queuename] 


Command 
Qualifiers: /ALL 
/BRIEF 
/DEVICE 
/PRINTER 
/ENTRY:n 
/FILES 
/FORMS:n 
/FULL 

/NAME:jobname 

/OWNER_UIC:[[g, 

/PRINTER 


All entries in all queues 

Same as /PRINTER; all queues 
Same as /DEVICE 

Files in each job; shorter than /FULL 

>]] 

Same as device 


Displays information about print jobs in queues. 
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SHOW SYSTEM SHOW SYSTEM[/qualifier] 

Command 
Qualifiers: /CLI 

/DIRECTORY Default; displays system UFD 

/EXTENSION_LIMIT 

/PACKETS 

/POOL 

Displays information about the current system. 

SHOW TASKS SHOW TASKS[:taskname]/qualifier[s] 

Command 

Qualifiers: /ACTIVE[:ttnn:] 

/INSTALLED 

/LOGICAL-UNITS 

/BRIEF 

/FULL 

/ALL 

Displays information about active or installed tasks. 

SHOW TASKS/DYNAMIC 

Format to display task header: 

SHOW TASK:taskname/DYNAMIC[/qualifier] 

Command Qualifier: /RATE:n 
Format to display Active Task List: 

SHOW TASKS/ACTIVE/DYNAMIC[/qualifier[s]] 

Command 

Qualifiers: /OWNER:ddnn: Default is /ALL 

/ALL 

/PRIORITY:n Default for n is 250 

/RATE:n Rate in seconds for display change; 

Default is 1. 

Invokes RMD to display on a video terminal continuing changes to either a 
single task header or to all or part of the Active Task List. On a hard-copy 
terminal, SHOW TASKS/DYNAMIC provides a snapshot display. 

SHOW TERMINAL SHOW TERMINAL[:ttnn:][/qualifier] 

Command 

Qualifiers: /[NOJASR33 
/[NO]ASR35 
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Command 

Qualifiers: /[NOJCRFILL 
/DCL 

/[NO]ECHO 

/[NOJEIGHT_BIT 

/[NOJESCAPE 

/[NO]FORM_FEED 

/[NO]FULI_DUPLEX 

/[NO]HARDCOPY 

/[NO]HOLD_SCREEN 

/[NO]INTERACTIVE 

/[NO]KSR33 

/[NO]LA30S 

/[NOJLA30P 

/[NO]LA36 

/[NOJLA120 

/[NOJLA180S 

/[NOJLFFILL 

/[NO]LOCAL 

/[NO] LOWERCASE 

/MCR 

/MODEL 

/PAGE_LENGTH 

/[NOJPASSALL 

/[NO]PRIVILEGE 

/[NOJREMOTE 

/[NO]SCOPE 

/[NOJSERIAL 

/[NO]SLAVE 

/SPEED 

/[NO]TAB 

/[NOJTYPE_AHEAD 

/[NO] UPPERCASE 

/[NOJVT05 

/[NO]VT50 

/[NOJVT52 

/[NO]VT55 

/[NO]VT61 

/[NO]VT100 

/[NOJWRAP 

Displays information about your terminal and other terminals on your 

system. 
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SHOW USERS SHOW USERS 

Displays all currently logged-in terminals, including DECnet host termi¬ 
nals and virtual terminals, with the default UFD and login UIC for each. 

SORT [/KEY:(abm.n[abm.n])][/quallfier[s]] lnflle[/qual]outflle/FORMAT:(arg) 
Command 

Qualifiers: /ALLOCATIONS 

/BLOCK—SIZE:n Infile or outfile 

/BUCKET_SIZE:n 

/[NOJCONTIGUOUS 

/DEVICE:ddnn: 

/PROCESS:type 

ADDRESS-ROUTING 

INDEX 

RECORD 

TAG 

/SIZE:n 

/SPECIFICATION:filespec 
/WORK—FILES:n 

File 

Qualifiers: /FORMAT:(format,[n]) 

FIXED 
STREAM 
UNKNOWN 
VARIABLE 
/INDEXED:n 
/RELATIVE 
/SEQUENTIAL 

Invokes the SORT-11 utility, if present. 

START STARTf/qualifier] [taskname] 

Command 

Qualifier: /TERMINALrttnn: (P) 

Resumes execution of a task stopped by a STOP$S directive. Taskname 
defaults to TTnn. 

START PROCESSORNAME (P) START/qualifier processorname/qualifier 
Command 

Qualifiers: APPLICATIONS—PROCESSOR 
BATCH—PROCESSOR 
CARD—READER Same as INPUT 


Required on infile. 

Optional on outfile; n is size 
in bytes. 


Infiie 

Outfile 

Outfile 
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Command 

Qualifiers: DEVICE 


Same as PRINTER 
Same as CARD_READER 
Same as DEVICE 


INPUT 

PRINTER 

PROCESSOR 


Parameter 

Qualifiers: /FORMS:n 


Overrides initialization value 
Default is CONTINUE 


/CONTINUE 


/RESTART 

/NEXT 

/TOP_OF_FILE 

/BACKSPACES 

/FORWARDSPACE:n 

/PAGE:n 

/ALIGN 


Starts an output processor or cardreader processor. 

START/QUEUE (P) START/QUEUE queuename 

Starts a queue. 

START/QUEUE/MANAGER (P) START/QUEUE/MANAGER 

Starts the Queue Manager. 

START/UNBLOCK START/UNBLOCK [taskname] 

Continues the execution of a task blocked by the STOP/BLOCK com¬ 
mand. Nonprivileged users can unblock any task running from their own 
terminals. Privileged users can unblock any task. 

STOP/ABORT STOP/ABORT prlnter[:] 

Stops the current job on a line printer immediately. Privileged users can 
stop any job. Nonprivileged users can stop only their own jobs. 

STOP/BLOCK STOP/BLOCK [tasknamel 

Blocks an installed running task. The task no longer executes or competes 
for memory. Nonprivileged users can block tasks running from their own 
terminals. Privileged users can block any task. 

STOP PROCESSORNAME (P) STOP/qualifier processorname/qualifier 

Command 

Qualifiers: APPLICATIONS_PROCESSOR 


BATCH_PROCESSOR 
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Command 

Qualifiers: CARD_READER 


Same as INPUT 
Same as PRINTER 
Same as CARD-READER 
Same as DEVICE 


DEVICE 

INPUT 

PRINTER 

PROCESSOR 


Parameter 
Qualifiers: /ABORT 


/FILE—END 
/JOB—END 
/PAUSE 


Stops a batch processor, card-reader processor, printer, or other output 
processor. 

STOP/QUEUE (P) STOP/QUEUE queuename 

Stops queues. 

STOP/QUEUE/MANAGER (P) STOP/QUEUE/MANAGER 

Command 

Qualifier: /ABORT 

Stops the Queue Manager after the current job. /ABORT stops the Queue 
Manager immediately. 

TYPE TYPE fllespecls] 

Prints selected files on your terminal. See APPEND command description 
for other qualifiers. 

UNFIX UNFIX taskname 

Frees a fixed task or region from memory. Taskname can also be a region 
name. 

UNLOCK UNLOCK filespec[s] 

Unlocks locked files. Locked files are files that have been improperly 
closed. They are identified by an L in the directory listing. See APPEND 
command description for other qualifiers. 
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ERROR LOGGING SYSTEM 


The Error Logging System records information about errors and events that 
occur on system hardware for immediate action or later analysis and reporting. 
The system consists of four tasks: 

• The Error Logger (ERRLOG) 

• The Error Log Interface (ELI) 

• The Report Generator (RPT) 

• The Control File Language Compiler (CFL) 

This section describes the ELI commands that run ERRLOG and the RPT 
commands that generate error log reports. 

ELI COMMANDS 

The general format for an ELI command is: 

[filespecj/switchl [/...switchn] 
filespec 

A device mnemonic or the name of an error log file, backup file, or file 
to append to the current error log file. 

switches 

Switches to set, change, or display ERRLOG operation. You must 
specify at least one switch on each ELI command line. 

Using ELI Defaults: 

ELI /LOG© 

This command starts ERRLOG, using LB:[l,6lLOG.ERR as the error log file 
and LB:[1,6]BACKUP.ERR as the backup file. It also starts error limiting on the 
error log devices. 

Switches: 

APPEND filespec/AP 

Appends a previous log file to the current error log file. Logging must be 
active for this switch to work. 

BACKUP filespec/BA 

Sets the name for a backup file to the next highest version of the file 
named. This file is used if the primary error log file becomes unusable. 
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HARD ERROR LIMIT device(s)/HL:n 

Sets limit (n) for hard (unrecoverable) errors on a device or devices. If 
limiting is turned on and the hard error limit is reached, logging of hard 
errors for that device stops. 

LIMITING /LIM 

Starts the use of error limiting, using either default limits or those set with 
ELI switches. 

LOGGING [filespec]/LOG 

Begins error logger operation, turns on error limiting, and, if you specify a 
file name, overrides the default name of the error log file 
(LB:[l,6]LOG.ERR). 

NOLIMITING /NOLIM /-LIM 

Stops the use of error limiting. 

NOLOGGING /NOLOG /-LOG 

Stops error logger operation and turns off error limiting. 

RESET device(s)/RE 

Resets the QIO and error counts on the specified devices to 0. You may 
specify up to 14 devices. 

SHOW [device(s)]/SH 

Displays error logging information for the specified devices or, if you do not 
specify device names, for all error logging devices on the system. Also 
displays information about the current operating status of the error logging 
system. 

SOFT ERROR LIMIT device(s)/SL:n 

Sets limits (n) for soft (recoverable) errors on a device or devices. If limit¬ 
ing is turned on and the soft error limit is reached, logging of soft errors for 
that device stops. 

SWITCH filespec/SW 

Copies the current error log file to the file specified and begins logging in 
that file. 


116 





Error Logging System 


RPT COMMANDS 

The general format for an RPT command is: 

[reportfile][/switch(es)]=[inputfile] [/switches] 

reportfile 

The name of the listing file that contains the Error Log Report, 
switches 

Optional switches to control how RPT selects and formats informa¬ 
tion from the error log file. You can use the switches with either the 
output report file specification or the input file specification. 


Default: 

rpt =m 

The default command line selects the following RPT switches: 

/F[ORMAT]:B[RIEF] 

/T[YPE]:A[LL] 

/DA[TE]:RANGE:*:* 

/P[ACKET]:*:* 

/D[EVICE]:ALL 

/W[IDTH]:W[IDE] 

Switches: 

DATE /DA:qualifier 

Qualifiers: P[REVIOUS]:ndays 

R[ANGE]:start:end 
T[ODAY] 

Y[ESTERDAY] 

Allows you to select packets based on the time of their occurrence. 

DEVICE /DE:qualifier 

Qualifiers: (devicename(s)) 

A[LL] 

Allows you to select packets for peripheral errors based on device or con¬ 
troller name. 
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FORMAT F:qualifier 

Qualifiers: B[RIEF] 

F[ULL] 

N[ONE] 

R[EGISTERS] 

Allows you to specify the desired format for the packet-by-packet report. 

PACKET NUMBER /PA:bbbb.xxx(:bbbb.xxx) 

Allows you to select a packet or range of packets by specifying the packet 
identification number, bbbb is the block number and xxx is the record 
number. A packet specified as * indicates open ended. 

REPORT /Rrqualifier 

Qualifiers: D[AY] 

MONTH 

WEEK 

SYSTEM 

userstring 

Invokes a predefined string of switches for RPT to use. The qualifier can be 
one of the DIGITAL-defined strings or a user-defined switch string. 

The DIGIT AL-defined strings and their switches are: 

SYSTEM /FO:BR/TY:A/DA:RA:*:*/PA:*:*/WI:WI 

WEEK /FO:BR/TY:A/DA:PRE:7/WI:WI 

MONTH /FO:BR/TY:A/DA:PRE:31/WI:WI 

DAY /FO:FULL/TY: A/DA:TODAY/WI: WI 
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SERIAL NUMBER /SE:qualifier 

Qualifiers: D[RIVE]:number and/or 

P[ACK]:number 

Selects packets based on drive or pack serial number. 

TYPE /Trqualifler 

Qualifiers: A[LL] 

C[ONTROL] 

E[RRORSJ 

M[EMORYl 

PEfRIPHERAL] 

PROCESSOR] 

S[YSTEM_INFO] 

Selects packets based on packet type or types. 

VOLUME LABEL /V.volumelabel 

Selects packets based on volume label. 

WIDTH /W:qualifier 

Qualifiers: N[ARROW] 

W[IDE] 

Selects the width of the report RPT creates (80 or 132 characters). 


Many RPT switches accept lists of qualifiers. The format for these lists is: 
/switch:(qualifier 1, qualifier 2...) 
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PROCEDURE FOR HALTING A JOB IN A PRINT 

QUEUE 


The following section describes the commands to stop a job on a print processor 
without actually disabling the processor or queue manager. The procedure is 
useful when you accidentally queue a large job that should not be printed. 

STOP/ABORT (/KIL) deletes the active job on a given processor. 

Privileged users can delete any job; nonprivileged users can delete their own 
jobs. You do not need to know the queue name or job name, but rather the name 
of the processor to delete the job. 

Format 

DCL>STOP/ABORT processorname 
MCR>QUE processorname:/KIL 

processorname 

Specifies the processor whose active job you wish to delete. Note that the 
MCR command format requires a colon ( : ) after the processor name. 

You can stop jobs running on any processor under the control of QMG. 

Examples 

DCL>STOP/ABORT 
Processor? LPO 

This example shows how to stop a print job on line printer LPO:. The 
currently active job is deleted from the queue and the next eligible job is 
queued up. 

Notes 

Use this command to stop a processor fast, such as a line printer printing 
nothing but form feeds. 

As soon as the active job is deleted, QMG passes the next eligible job to the 
processor. The processor has not been aborted or killed, but only the active 
job on that processor. 

You can also delete the active job on a card-reader processor with this 
command. 
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ON-LINE DEBUGGING TOOL (ODT) COMMANDS 

OPEN/DISPLAY/MODIFY TASK LOCATIONS 

address mode-symbol contents new-value terminator 

address (a) 

Specifies the effective address of the location (word or byte) to be opened. 
The address can be expressed absolutely or in relative form (see Relocata¬ 
ble Address). An odd address forces byte mode. 

mode-symbol 

Specifies the mode in which the location is to be opened or displayed. If the 
address is not specified, the last opened location is opened and displayed. 

Symbol Open/Display Location As: 

/ 6-digit octal word 

\ 3-digit octal byte 

2 ASCII characters (word) 

1 ASCII character (byte) 

% 3 Radix-50 characters (word) 

contents 

Specifies the current contents of the opened location. 

new-value [k| 

Specifies the optional value to replace the current contents upon termina¬ 
tion of the command line. 

terminator 

Closes the currently open location, replacing the current contents (if so 
directed). The terminators are: 

Return © 

Terminates the current sequence, displays the ODT prompt (_), and 

waits for the next command. 

Line feed (lf) 

Opens the next sequential location and prints its contents. 
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Circumflex (~) or up-arrow (t) 

Opens the preceding location in the current mode. If typed as an ODT 
prompt rather than as a terminator, opens the location that precedes 
the last-opened location in the same mode. 

Underline (_) or back-arrow (-) 

Opens the PC-relative location. The effective address equals the con¬ 
tents (previous or replaced) of the current location added to its ad¬ 
dress plus 2. Mode is the same, except that odd effective addresses 
force byte mode. 

At sign (@) 

Opens the location addressed absolutely by the contents (previous or 
replaced) of the current location. Mode is the same, except that odd 
effective addresses force byte mode. 

Right angle bracket (>) 

Opens the PC-relative branch-offset location. The effective-address 
calculation involves the low-order byte of the contents (previous or 
replaced) of the just-closed location. Byte, as a signed value, is multi¬ 
plied by 2 and added to its effective address plus 2. Mode remains the 
same as when the location was opened. 

Left angle bracket (<) 

Reopens the location most recently opened by a /, <LF>, or *. If the 

currently open location was not opened by a_, or >, then < closes 

and reopens the current location. 

COMMAND INPUT ERRORS 

Individual characters in a command line cannot be corrected. In general, 
typing an illegal character or command (such as 8 or 9) causes ODT to 
ignore the input, print the question mark error indicator (?), and wait for a 
valid command. 

RELOCATABLE ADDRESS 

An effective address can be entered as an explicit value relative to (plus) 
the contents of a relocation register; typically the register contains the 
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relocatable base address for the applicable program section or object mod¬ 
ule. ODT displays task addresses in relative form if a relocation register 
contains an address-offset value equal to or less than the address to be 
displayed; if the Format Register ($F) contains 0, ODT also displays the 
register’s initialized state. Otherwise, ODT displays addresses in absolute 
form. The relocation registers are identified as OR through 7R; a null value 
is taken as 0 when an offset is established. The registers initially contain 
-1, the nonactive state. 

Establishing Relocatable Address Offsets 

value;nR Value replaces current contents of relocation register n. 

n,value;nR Value is added to (subtracted from) current contents of relo¬ 
cation register n. 

$nR/ Displays current contents of relocation register n. New value 

is typed before terminator replaces current contents. 

Inhibiting Relocatable Addressing 

R Sets all active relocation registers to -1, the nonactive state. 

nR Sets relocation register n to -1, the nonactive state. 

Entering or Displaying Relative Address 

Effective address is address relative to (plus) the current 
contents of relocation register r. 


BREAKPOINTS 

A breakpoint must be set in the first word of an instruction. Breakpoints 
are identified as OB through 7B. (8B is reserved for use with single step 
execution.) A breakpoint address can be entered in absolute or in relative 
form (see Relocatable Address). 

Inserting Breakpoints 

r,address;nB Inserts breakpoint n at specified address. 
r,address;B Inserts next unset breakpoint at specified address. 

Removing Breakpoints 

B Removes all inserted breakpoints. 

nB Removes only breakpoint n. 
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Moving Breakpoints 

r,address;nB Moves breakpoint n to new address, overriding previous ad¬ 
dress. 

Report of Breakpoint Occurrence 

nB:r,address Reports address at which breakpoint n suspended task exe¬ 
cution. 


Displaying Breakpoint Position 


$nB/ 

Displays current absolute address (or inactive state) of 
breakpoint n. Entering a replacement value alters the cur¬ 
rent contents of the breakpoint register. 

CONTROL OF TASK EXECUTION 

Go Command 

G 

Initiates task at entry address. 

r,address G 

Initiates task at specified address (address must be even). 
Execution continues to a breakpoint or to completion. 

Proceed Command 

P 

Resumes task execution from current breakpoint suspen¬ 
sion, and continues to a breakpoint or completion. 

nP 

Resumes task execution from current breakpoint suspen¬ 
sion, and does not recognize this breakpoint again until its 
nth occurrence. 

$nC 

Displays current contents of the proceed-count register asso¬ 
ciated with breakpoint n. New value typed before termina¬ 
tor replaces current contents. 


Instruction Command 

Executes PC-addressed instruction, suspends task, and 
prints address of next instruction. 

Executes next n instructions, suspends task, and prints ad¬ 
dress of next instruction. 

8B:r,address Specifies the next instruction’s address. 

FILL MEMORY BLOCK - F COMMAND 

The memory-limit registers, low ($L) and high ($H), must contain the 
address boundaries of the affected memory area. Both contain 0 initially. 


Single- 

S 

nS 
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The following sequence establishes the address reference, which can be in 
relative or absolute form: 

$L (or $H)/contents new-address terminator 

value F Places a value in search argument register ($A), and/or en¬ 

ters the current contents of ($A) in all memory locations 
from low limit ($L) through high limit ($H) in the same 
mode as the last-opened location. 

LIST MEMORY BLOCK - L COMMAND 


L 

Prints memory locations within specified address limits on 
console listing device (CL:). 

kL 

Uses address value k as ending location and initiates listing 
operation. 

a;L 

Uses address value a as a beginning location and initiates 
listing operation. 

a;kL 

Uses address values a and k as beginning and ending ad¬ 
dresses and initiates listing operation. 

n;a;kL 

All listing control arguments are specified in a single listing 
command; n is the LUN register containing the address of 
the listing device. 


CALCULATING OFFSETS - O COMMAND 

Calculates positive or negative (2’s complement) PC-relative and branch 
offsets between even (word) addresses. 

From Open Location 

address/contents/addressO pc-rel>branch 
Example: 16126/001402/161340 000004 > 000002 

Between Two Specified Addresses 

address;addressO pc-rel>branch 
Example: 16126;161340 000004>000002 

GENERAL PURPOSE REGISTERS 
C Constant Register 

Contains user-specified 16-bit value (unsigned, absolute) for reference as 
“C” in any address or new-value expressions. $C/ prints current contents. 
New value typed before ®et) replaces contents. 
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Q Quantity Register 

Always contains the last value printed for reference as “Q” in address or 
new value expressions. 

PROCESSOR STATUS WORD 
$S / 

Displays the task Processor Status Word (PSW). The new value typed 
before the terminator replaces the old PSW contents. 

DIRECTIVE STATUS WORD 
$W / 

Displays a task’s Directive Status Word ($DSW). The new value typed 
before the terminator replaces the old contents. 

MISCELLANEOUS SYMBOLS AND OPERATORS 

+ or space Sums contiguous arguments. 

Subtracts the following argument from the preceding one. 

Equals address of the last explicitly opened location. 

= Calculates the 16-bit value (positive or 2’s complement) of 

the preceding argument string, prints it as 6 octal digits, 
and stores it in Q. Arguments can be signed or unsigned 
octal values, relocatable address expressions, or any valid 
ODT expression. 

TERMINATING ODT SESSION 

X Terminates ODT and returns control to the system monitor. 

For additional information, refer to the IAS/RSX-U ODT Reference Manual. 
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The format for Task Builder commands is: 

>TKB 

TKB>taskimagefile,memallocfile,symdeffile = inputfile(s) 


For example, to task-build a program called Zebra, type: 

>TKB 

TKB>ZEBRA.TSK,ZEBRA. MAP,ZEBRA.STB = ZEBRA.OBJ.... 

TKB>/ 

ENTER OPTIONS: 

TKB> optionname = argument(s) 

TKB>//(to end Task Builder operation) 
or 

TKB>/(if you have another task to build) 

The Task Builder file specification is: 

filespec = dev:[g,m]filename.typ; version/switch(es) 
defaults = SY: [uic]filename.typ;n/switch 

The Task Builder uses the following default file types for the files named: 


Task Image File 

.TSK 

Memory Allocation File 

.MAP 

Symbol Definition File 

.STB 

Object Module 

.OBJ 

Overlay Description 

.ODL 

Indirect Command 

.CMD 

Object Module Library 

.OLB 


In the file specification above, n is the latest version number for an input file and 
the latest version plus 1 for an output file. 
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SWITCHES 


The following key is used in the description below to designate which input and 
output files can use the Task Builder switch specified: 


[C] 

Common or Library 

(.TSK)* 

[T] 

Task Image 

(•TSK) 

[M] 

Task Builder Map 

(.MAP) 

[S] 

Symbol Definition 

(STB) 

[I] 

Input 

(.OBJ,.OLB,.ODL,.CMD) 


* Commons or libraries are specified with the /-HD switch, which produces a .TSK file 
without a header. 


The default value for switches is negative (-sw) unless otherwise specified. 

/AC:n 

Specifies that the task is an Ancillary Control Processor (ACP); n specifies 
the base relocation register (allowable registers are 0, 4, or 5; default regis¬ 
ter is 5). Overrides /PR if applied to the same file. [T] 


/AL 

Makes the task image file checkpointable and allocates checkpoint space 
in the task image file. (Do not use with /CP in the same command line.) [T] 

ICC 

Specifies that the input file contains more than one object module. /-CC 
task-builds only the first object module. The LB (library) switch overrides 
/CC if it is applied to the same file. (Default is /CC.) [T] 

/CM 

Specifies a compatibility mode resident overlay structure. (Overlay seg¬ 
ments are aligned on 256-word physical boundaries.) [T] 

ICO 

Causes the Task Builder to build a shared common. [C] 

/CP 
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Makes the task image checkpointable and allows the task to be check- 
pointed to system checkpoint space. (Do not use in the same command line 
with /AL.) [T] 
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/CR 

Appends a global cross-reference listing to the memory-allocation file. [M] 

/DA 

Includes a debugging aid in the task image (ODT) for a task image (out¬ 
put) file or a user-supplied debugging program (for an input file). [T,I] 

/DL 

Specifies a default library file (replacing SYSLIB.OLB) for global refer¬ 
ences that remain undefined after user-specified library files have been 
searched. (Can be applied to only one input file per task.) [I] 

/EA 

Specifies that the task uses the extended arithmetic element. (/FP over¬ 
rides /EA if applied to the same file.) [T] 

/EL 

Specifies the maximum possible size for the library, according to the size 
specified in the PAR option. (The actual size of the library may be 
smaller.) 

/FP 

Specifies that the task uses the floating-point processor. (Overrides /EA if 
applied to the same file.) [T] 

/FU 

Specifies a full search of all co-tree segments for a matching definition or 
reference when processing modules from the default object module library. 

m 

/HD 

Includes a header in the task image. (Default is /HD; /-HD is used with 
common blocks, resident libraries, loadable drivers, and system images.) 

n\si 

/ip 

Allows the Task Builder to inform INSTALL that the privileged task pur¬ 
posely overmaps the I/O page. Conversely, /-IP informs INSTALL that the 
privileged task is over 12K and does not map the I/O page. [T] 
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/LB 

Without arguments: TKB uses the input file as a library of relocatable 
object modules and searches to resolve undefined global references. In¬ 
cludes in task image any modules found in the library that resolve the 
undefined references. [I] 

With arguments: [/LB:mod-lmod-2.] TKB inserts only the modules 

named in the command, regardless of references, into the task image. [I] 

/LI 

Causes the Task Builder to build a library shared region. Use the /-HD 
switch with /LI. 

/MA 

Includes information from the input file in the memory allocation listing 
(when applied to an input file) or controls the display of information about 
the default library and shared regions (when applied to a memory alloca¬ 
tion file). (Default is /MA for input file or /-MA for a memory allocation 
file.) [M,I] 

/MM[:n] 

Specifies that the system on which the task is to run has memory manage¬ 
ment hardware. (Defaults to /MM if host system has memory manage¬ 
ment, or to /-MM if it does not.) [T] 

n with /-MM to specify the highest physical address in K-words of the 
task or system being built. Specify as decimal numbers 28. or 30. 

IMP 

Specifies that the input file describes the task’s overlay (tree) structure; 
the input file is an .ODL file. [I] 

/NM 

Tells the Task Builder not to print diagnostic messages. [T] 

/PI 

Specifies that only position-independent code or data is in the shared 
region. [T,S] 

/PM 

Produces a Postmortem Dump if the task is terminated with an SST abort. 

[T] 
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/PR:n 

Specifies that the task has privileged access. /AC overrides /PR:n if applied 
to the same file; n specifies base relocation register (0, 4, or 5; default is 5). 
[T] 


/RO 

Enables recognition of the memory-resident overlay operator (!) in the 
overlay descriptor file (/MP]. (Default is /RO.) [T] 

/SE 

Specifies that the task can receive messages by means of the Executive 
SEND directive. (Default is /SE.). [T] 

/SG 

Allocates task program sections alphabetically by access code (RW fol¬ 
lowed by RO). [T] 

/SH 

Produces a short form of the memory-allocation file without the file con¬ 
tents section. [M] 

/SL 

Specifies that the task is slaved to an initiating task. Slave task runs under 
the UIC and TI: of the sending task. (Applies only to systems with mul¬ 
tiuser protection.) [T] 

/SP 

Lists the memory-allocation file on the printer via the spooler. (Default is 
/SP.) [M] 

/SQ 

Builds program sections in the task image in the order in which they are 
named, rather than in alphabetical order. (Cannot be used with FOR¬ 
TRAN I/O handling modules or FCS modules from SYSLIB.) [T] 

/SS 

Extracts a global symbol definition from the input file if the global symbol 
table has a matching undefined reference. [I] 
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/TR 

Specifies that the task can be traced. [T] 

/Wl 

Lists the memory-allocation file in 132-column (wide) format. (Default is 

AVI.) [M] 

/XT:n 

Terminates the building of the task after n error diagnostics are detected; n 
can be octal or decimal (decimal must be specified with a decimal point, 
for example, 8.). 

OPTIONS 

[H] 

Option is of interest to high-level language programmers. 

[M] 

Option is of interest to MACRO-11 programmers. 

[H,M] 

Option is of interest to both high-level language and MACRO pro¬ 
grammers. 

Names used for option input can be 6 characters long, from the Radix-50 charac¬ 
ter set (A-Z, 0-9, and $). 

ABORT = n 

Terminates the current task-build operation and restarts the Task Builder 
for another. (The n satisfies the option syntax; it means nothing.) [H,M] 

ABSPAT = segname:address:value1 ...:value8 

Patches the task image from a base address. Also patches the I-space part 
of an I- and D-space task. Eight values may be specified. [M] 

ACTFIL = filemax (decimal integer) 

Specifies the number of files that a task can have open simultaneously (the 
default is 4). [H] 
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ASG = devicename:un1...:un8 

Assigns logical unit number(s) in decimal to specified physical device(s). 
[H,M] 

CLSTR = library—^1 ,library_2,...,library_n:switch:apr 

Declares a cluster or group of system-owned resident libraries or commons 
(from two to six) to be accessed by the task and all residing at the same 
virtual address space in the task. [H, M] 

Switch Read-only or read-write access for the task (RO or RW) 

APR Which APR is to be used as the starting APR for the task 

COMMON = name:access-code|: apr ] 

Declares that the task accesses a system-owned resident common area. 
[H,M] 

DSPPAT = segname:address:value1...:value8 

Patches the task image from a base address. Also patches the D-space part 
of an I- and D-space task. Eight values may be specified. 

EXTSCT = psectname:extension 

If the program section has the concatenated attribute, this option extends 
the size of the named program section by the number of octal bytes speci¬ 
fied in the extension. If the program section has the overlay attribute, it is 
extended only if the extension value exceeds the length of the section. 
[H,M] 

EXTTSK = n 

Extends the task memory allocation by the length n (in decimal words in 
the range 0<n<65,535.) when it is installed in a system-controlled parti¬ 
tion. The extension is rounded to the closest 32-word boundary. The de¬ 
fault is the extension to the total task size as specified by the PAR option 
length parameter. [H,M] 

FMTBUF = max-format (decimal integer) 

Specifies the number of characters (in decimal bytes) in the longest format 
specification to be compiled at run time. The default is 132. [M] 

GBLDEF = symbol-name:symbol-value 

Defines the named global symbol as having a value in the range of 0 
through 177777 (octal). [M] 
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GBLINC = symbolname,symbolname...,symbolname 

Specifies the symbols to be included as undefined references in the symbol 
table file of a shared resident library. [M] 

GBLPAT = segname:symname| +/-offset]:val1 ...:val8 

Patches the task image from the location addressed by the global symbol 
plus or minus the octal offset value through eight words. All values are 
octal. [M] 

GBLREF = symbol-name:symbol-value 

Declares the named symbol as a global symbol reference originating in the 
root segment of the task. [H,M] 

GBLXCL = symbolname:symbolname:...:symbolname 

Specifies the symbols that are to be excluded from the symbol definition 
file of a resident library. [H,M] 

LIBR = name:access-code|:apr] 

Declares that the task accesses a system-owned resident library. [H,M] 

MAXBUF = max-record 

Specifies the maximum allowable record buffer size (in decimal bytes) in 
any file processed by the task. [H] 

ODTV = symbol-name:vector-length 

Declares the named global symbol to be the address of the ODT synchro¬ 
nous system trap vector (SST). The global symbol must be defined in the 
main root segment. [M] 

PAR = name[:base:length] 

Identifies the partition for which the task is built. For a mapped system, a 
size of 0 implies a system-controlled partition, and a nonzero size implies a 
user-controlled partition. Base and length do not have to be expressed if 
the partition resides on the host system. The default is PAR = GEN. [H,M] 
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PRI = priority 

Sets the priority at which the task executes; can be overridden when the 
task is installed. The priority is a decimal integer between 1 and 250. [H,M] 

RESCOM = filespec/access-code| :apr] 

Declares that the task accesses a user-owned resident common. [H,M] 

RESLIB = filespec/access-code[:apr] 

Declares that the task accesses a user-owned resident library. [H,M] 

TASK = taskname 

Names the task. [H,M] 

TSKV = symbol-name:vector-length 

Declares a global symbol to be the address of the task synchronous system 
trap vector (SST). [M] 

UIC = [g,m] 

Declares the UIC for time-based initiation of a task. The default is the UIC 
under which the Task Builder is running. [H,M] 

UNITS = max-units 

Declares the number of logical units used by the task (a decimal number in 
the range of 0 through 250). The default is 6. [H,M] 

VSECT = psectname:base:window|:physical-length| 

Specifies the virtual base address, length of virtual memory address space 
(window), and length of physical memory allocated to the named program 
section. [H,M] 

WNDWS - n 

Declares the number (0 through 7) of extra address windows required by 
the task. The number specified equals the number of simultaneously 
mapped regions that the task will use. [H,M] 
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RMSBCK UTILITY SUMMARY 


The RMS-11 File Back-Up Utility (RMSBCK) transfers the contents of an 
RMS-11 file to another file, on another device, to maintain the file should the 
original file be lost or damaged. 

The command line for the RMSBCK utility is: 

outfile[/switch...]=infile[/switch...][,infile[/switch. 

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more 
information. 

The RMSBCK switches are listed below. 

Global Switches 

/ID 

Identifies the current version. Default: Provides no identification. 

/[NO]QU 

Enables or disables query mode. Default: Enables query mode. 

/SL[:file-spec] 

Provides summary listing to terminal or in file, if specified. Default: Pro¬ 
vides no summary. 

Output File Switches 

/RA 

Performs read-after-write data integrity checking. Default: Does no read- 
after-write checking. 

/RC 

Performs check-after-writing data integrity checking. Default: Does no 
check-after-writing. 

/RW 

Rewinds magnetic tape before writing. Default: Does not rewind magtape. 

/SU 

Supersedes existing file. Default: Does not supersede file. 
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Input File Switches 

/CD:dd-mmm-yy[: v] 

Backs up files based on creation date: specify v as A to back up all files 
created after the date specified or as B to back up all files created before 
the date specified. If v is not specified, all files created on the date specified 
will be backed up. Default: Performs no date checking. 

/RD:dd-mmm-yy[:vJ 

Backs up files based on revision date: specify v as A to back up all files 
revised after the date specified or as B to back up all files revised before the 
date specified. If v is not specified, all files revised on the date specified 
will be backed up. Default: Performs no date checking. 
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The RMS-11 File Conversion Utility (RMSCNV) reads records from an RMS-11 
file of any organization and loads them into another RMS-11 file of any organi¬ 
zation. 

The command line for the RMSCNV utility is: 
[outfile[/switch...]=]infile[/switch...] 

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more 
information. 

The RMSCNV switches are listed below. 

Global Switches 

/AP 

Appends records to an existing sequential file. Default: Does not append. 

/BL:[n] 

Sets magnetic tape block size. Default: Uses 512 bytes. 

/CA:[file-spec] 

Creates an output file with the attributes of the existing input File. Default: 
Output file must exist or RMSCNV creates a sequential file. 


/EO 

Converts CTRL/Z EOF character in an ASCII stream file to null and pads 
the file with nulls to the physical EOF. Default: Assumes null-filled stream 
file. 

/FO:x 

Sets output file organization, where x is S, R, or I. Default: Uses 
sequential (S) organization. 


/ID 

Identifies the current version. Default: Provides no identification. 

/IM 

Processes files in block mode. Default: Uses standard RMS-11 access 
modes. 
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/KN:["]keyname["] 

Reads an indexed file using the key of reference specified by keyname. 
Default: Reads file using primary key. 

/KR:n 

Reads an indexed file using the key of reference specified by n. Default: 
Reads file using primary key (0). 


/ LO 

Honors bucket fill size when filling buckets in an indexed file. Default: 
Fills buckets to capacity. 

/MA 


Uses mass-insertion mode and sequential PUT operations. Default: No 
mass insertion; uses random PUT operations. 

/ML:n 

Explicitly sets limit of buffer allocation. Default: RMSCNV calculates the 
amount of memory available for allocation. 

/PD[:[#]["]x["]] 

Pads input records to output record length, if necessary. Default: Does not 
pad records. 

/SL[:file-spec] 

Provides summary listing to terminal or in file, if specified. Default: Does 
not provide summary. 


/ SU 

Supersedes existing sequential file. Default: Does not supersede existing 
file. 

/TR 

Truncates input records to output record length, if necessary. Default: 
Does not truncate records. 


/WF 

Writes or reads fixed-control area. Default: Ignores fixed-control area. 
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RMSDES UTILITY SUMMARY 


The RMS-11 File Design Utility (RMSDES) allows you to design and create 
sequential, relative, and indexed files. 

The command line for the RMSDES utility is: 

DES filename[.typ) [kind] 

See the RMS-11 Utilities manual for more information. 

The following sections list the RMSDES attribute settings and commands. 


ATTRIBUTE SETTINGS 


Section 

Attribute Keyword 


Keyword 

and Variable 

Default 

System 

TARGET 1 argument 



argument must be one of: 

RSX 

RSTS 

User’s system 


SOURCE 1 - 2 

User’s system 


FILE PLACEMENT 1 logical 

NO 

File 

NAME string 

FILE.DAT 


ORGANIZATION argument 



argument must be one of: 
SEQUENTIAL 

RELATIVE 

INDEXED 

SEQUENTIAL 


CLUSTER_SIZE number 

0 blocks 


ALLOCATION number 

0 blocks 


EXTENSION number 

0 blocks 


BUCKET_SIZE number 

1 block 


PROTECTION string 

System protection 


1. Informational attribute. 

2. Not user settable: RMSDES automatically notes the user’s source system. 
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Section 

Attribute Keyword 


Keyword 

and Variable 

Default 


OWNER string 

User’s UIC 


MAGTAPE_BLOCK SIZE number 

512 bytes 


MAGTAPE_REWIND logical 

NO 


MAX—RECORD_NUMBER number 0 records 


CONTIGUOUS logical 

NO 


SUPERSEDE logical 

NO 

Record 

SIZE number 

0 bytes 


FORMAT argument 



argument must be one of: 
VARIABLE 

STREAM 

FIXED 

VFC 

VARIABLE 


CONTROL—FIELD_SIZE number 

2 bytes 

Record 

BLOCK_SPAN logical 

CARRIAGE_CONTROL argument 

YES 


argument must be one of: 

CARRIAGE_RETURN 

FORTRAN 

PRINT 

NONE 

CARRIAGE_RETURN 

Key n 3 

NAME string 

TYPE argument 

No name 


argument must be one of: 

STRING 

BIN2 

BIN4 

INT2 

INT4 

DECIMAL 

STRING 


3. You must specify a number (n) for each key, key segment, and/or area that you define. 
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Section Attribute Keyword 
Keyword and Variable 

NULL_KEY logical 

NULL-VALUE argument 

argument must be one of: 

An ASCII character 
A decimal number 

DUPLICATES logical 

SEGn_POSITION 3 number 
SEGn_LENGTH 3 number 
Key n 3 CHANGES logical 

DATA—FILL number 
DATA—AREA number 
INDEX—FILL number 
LEVEL1—INDEX—AREA number 
INDEX—AREA number 
Area n 3 ALLOCATION number 
EXTENSION number 
BUCKET—SIZE number 
CONTIGUOUS logical 
POSITION argument 

argument must be one of: 

NONE 

VIRTUAL number 
LOGICAL number 

EXACT—POSITIONING logical 


Default 

NO 


(space) 

NO (primary key) 
YES (alternate key) 

Byte 0 

0 bytes 

YES (alternate key) 
100 

Area 0 
100 

Area 0 
Area 0 
0 blocks 
0 blocks 
1 block 
NO 

NONE 

NO 


3. You must specify a number (n) for each key, key segment, and/or area that you define. 
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COMMANDS 

CLEAR ALL 

Restores all attribute values in all sections to their default values. 

CLEAR section ALL 

Restores all attribute values in the specified section to their default values. 

CLEAR section attribute 

Restores the specified attribute value in the specified section to its default 
value. 

CREATE [filenamef.typH 

Creates an empty data file that has the attribute values specified in the 
design buffer. For indexed files in which areas are not defined, RMSDES 
prompts for whether areas are to be defined by default. 

If you do not specify a file name and type, the file will have those specified 
in the design buffer. If you did not specify a file name and type in the 
design buffer, the file will be created as FILE.DAT. 

<CTRL/Z> 

Terminates RMSDES without saving the design or creating an empty data 
file. 

<ESC> 

In response to any prompt, returns the RMSDES utility prompt and pre¬ 
serves all attribute values in the design buffer. 

EXIT filename!.typ] 

Stores the file design in the description file specified in the command line 
and terminates RMSDES. The default file type is .DES. 

GET filename[.typ] [kind] 

Reads the file design specified in a description file, and sets the appropri¬ 
ate attribute values in the design buffer. Reads the attribute values of a 
data file, and sets the appropriate attribute values in the design buffer. 
The default file type is .DES. If the file is a data file, kind (DAT) must be 
specified. 





RMSDES Utility Summary 


HELP 

Lists all available help topics and gives instructions for displaying the text. 

HELP command 

Displays help text for the specified command. 

HELP COMMANDS 

Lists all valid commands. 

HELP SECTIONS 

Lists all available help topics for all sections and gives instructions for 
displaying the text. 

HELP section 

Displays help text for the specified section and lists all available help 
topics for all attributes in the specified section. 

HELP section attribute 

Displays help text for the specified attribute in the specified section. 

? 

Displays help text for the section, attribute, or value for which you are 
being prompted. Note also that you can type ? instead of HELP for any 
form of the HELP command. 


QUIT 

Terminates RMSDES, without storing the design or creating an empty 
data file. 

SAVE filename!.typ| 

Stores the file design in the description file specified in the command line. 
The default file type is .DES. 

SET ALL 

Prompts for setting all attribute values in all sections. For indexed files in 
which areas are not defined, prompts for whether areas are to be defined by 
default. 


147 






RMSDES Utility Summary 


SET section ALL 

Prompts for setting all attribute values in the specified section. 

SET section attribute value 

Sets the specified attribute value in the specified section. 

SHOW ALL 

Displays all attribute values in all sections. 

SHOW section ALL 

Displays all attribute values in the specified section. 

SHOW section attribute 

Displays the specified attribute value in the specified section. 

SHOW ID 

Identifies the current level and patch version of RMSDES. 
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The RMS-11 File Display Utility (RMSDSP) produces a concise description of 
any RMS-11 file, including back-up files. 

The command line for the RMSDSP utility is: 

[outfile=]infile[/switch...][,infile[/switch. 

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more 
information. 

The RMSDSP switches are listed below. 

Global Switches 

IBP 

Lists contents of back-up files. Default: Provides basic display only. 

/FU 

Provides detailed display for indexed files or back-up files. Default: Pro¬ 
vides basic display only. 

/ID 


Identifies the current version. Default: Provides no identification. 
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RMSIFL UTILITY SUMMARY 


The RMS-11 Indexed File Load Utility (RMSIFL) reads records from an 
RMS-11 file of any organization and loads them into an indexed file. 

The command line for the RMSIFL utility is: 

outfile[/switch...]=infile[/switch...] 

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more 
information. 

The RMSIFL switches are listed below. 

Global Switch 

/ID 

Identifies the current version. Default: Provides no identification. 

Output File Switches 

/ER[:file-spec] 

Writes primary keys of exception records to terminal if no file-spec; or 
writes exception records to the specified file. Default: Writes primary keys 
of exception records to terminal. 

/NOER[:S] 

Stops processing if input record is incompatible. Default: Writes primary 
keys of exception records to terminal. 


/LO 


Honors bucket fill size. Default: Fills buckets to capacity. 

/PD[:[#]xJ 

Pads input records to output record length. Default: Handles input records 
as exception records if different lengths. 


/TR 


Truncates input records to output record length. Default: Handles input 
records as exception records if different lengths. 
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Input File Switches 

/DE:dvn1 :[dvn2:...dvn5:] 

Reassigns devices for sort work files. Default: Creates and uses sort work 
files on SY:. 

/KR:n 

Uses key of reference number. Default: Uses primary key (0). 

/NOSO 

Does not sort records before loading. Default: Sorts records in input file 
before loading. 
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The RMS-11 File Restoration Utility (RMSRST) restores Files that were backed 
up using RMSBCK and produces standard RMS-11 files as output, so your 
programs can access them. 

The command line for the RMSRST utility is: 

outfile[/switch...]=infile[/switch...][,infile[/switch. 

Type HELP or ? for a help message. See the RMS-11 Utilities manual for more 
information. 

The RMSRST switches are listed below. 

Global Switches 

/ID 

Identifies the current version. Default: Provides no identification. 

/[ NOJCV 

Enables or disables file version number conversion. Default: For RMSBCK 
V2.0 or later, conversion is enabled and /NOCV will disable it. For 
RMSBCK tapes prior to V2.0, conversion is disabled and /CV will enable 
it. 

/[ NO]QU 

Enables or disables query mode. Default: Enables query mode. 

/SL[:file-spec] 

Provides summary listing to terminal or in file, if specified. Default: Pro¬ 
vides no summary. 

Output File Switches 

/FR 

Changes protection code. Default: Uses original protection. 

/RA 

Performs read-after-writing data integrity checking. Default: Performs no 
read-after-writing checking. 
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/ RC 

Performs check-after-writing data integrity checking. Default: Performs no 
check-after-writing checking. 

/SU 

Supersedes existing files. Default: Does not supersede existing files. 

Input File Switches 

/BD:dd-mmm-yy 

Restores disk files based on back-up date. Default: Performs no date 
checking. 

/OA:[uic] 

Restores files based on original account (UIC). Note that in this case, the 
square brackets are required syntax. Default: Applies no account criterion. 

/SE:file-spec or 

/SE:(file-spec1,file-spec2[,...,file-specl 0]) 

Restores specified files from container file. Default: Restores all files on 
container file. 
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RMS-11 COMPLETION CODES AND FATAL ERROR 

CODES 


The following sections list completions that are returned in the STS and STV 
fields of FABs and RABs, and fatal error completions. 

For more information on these codes, see Appendix A of the RMS-11 Macro 
Programmer’s Guide. 

COMPLETION CODES 


su$suc 

Operation succeeded 

Octal: 

Decimal: 

000001 

1 

SU$DUP 

Inserted record has duplicate key 

Octal: 

Decimal: 

000002 

2 

SU$IDX 

Error updating index 

Octal: 

Decimal: 

000003 

3 

ER$ACC 

File access error 

Octal: 

Decimal: 

177740 

-32 

ER$ACT 

Activity precludes operation 

Octal: 

Decimal: 

177720 

-48 

ER$AID 

Bad value in AID field 

Octal: 

Decimal: 

177700 

-64 

ER$ALN 

Bad mask in ALN field 

Octal: 

Decimal: 

177660 

-80 

ER$ALQ 

Bad value in ALQ field 

Octal: 

Decimal: 

177640 

-96 

ER$ANI 

Bad ANSI-format magtape file 

Octal: 

Decimal: 

177620 

-112 

ER$AOP 

Bad mask in AOP field 

Octal: 

Decimal: 

177600 

-128 

ER$ATR 

Error reading attributes 

Octal: 

Decimal: 

177540 

-160 

ER$ATW 

Error writing attributes 

Octal: 

Decimal: 

177520 

-176 

ER$BKS 

Bad value in BKS field 

Octal: 

Decimal: 

177500 

-192 
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ER$BKZ 

Bad value in BKZ field 

Octal: 177460 

Decimal: -208 

ER$BOF 

Beginning-of-file found 

Octal: 177430 

Decimal: -232 

ER$BPA 

Bad address in BPA field 

Octal: 177420 

Decimal: -240 

ER$BPS 

Bad value in BPS field 

Octal: 177400 

Decimal: -256 

ER$CCR 

RAB already in use 

Octal: 177340 

Decimal: -288 

ER$CHG 

Illegal record key change 

Octal: 177320 

Decimal: -304 

ER$CHK 

Bad bucket header 

Octal: 177300 

Decimal: -320 

ER$CLS 

File processor error 

Octal: 177260 

Decimal: -336 

ER$COD 

Bad code in COD field 

Octal: 177240 

Decimal: -352 

ER$CRE 

File processor error 

Octal: 177220 

Decimal: -368 

ER$CUR 

Undefined current-record context 

Octal: 177200 

Decimal: -384 

ER$DAN 

Bad value in DAN field 

Octal: 177140 

Decimal: -416 

ER$DEL 

Record having RFA deleted 

Octal: 177120 

Decimal: -432 

ER$DEV 

Bad device specification 

Octal: 177100 

Decimal: -448 

ER$DFW 

File processor error 

Octal: 177070 

Decimal: -456 

ER$DIR 

Bad directory specification 

Octal: 177060 

Decimal: -464 

ER$DME 

Pool exhausted 

Octal: 177040 

Decimal: -480 
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ER$DNA 

Bad address in DNA field 

Octal: 

Decimal: 

177030 

-488 

ER$DNF 

No such directory 

Octal: 

Decimal: 

177020 

-496 

ER$DNR 

Device not ready 

Octal: 

Decimal: 

177000 

-512 

ER$DPE 

Device positioning error 

Octal: 

Decimal: 

176770 

-520 

ER$DTP 

Bad code in DTP field 

Octal: 

Decimal: 

176760 

-528 

ER$DUP 

Duplicate key not allowed 

Octal: 

Decimal: 

176740 

-544 

ER$ENT 

File processor error 

Octal: 

Decimal: 

176720 

-560 

ER$ENV 

Feature not in selected RMS-11 environment 

Octal: 

Decimal: 

176700 

-576 

ER$EOF 

End-of-file reached 

Octal: 

Decimal: 

176660 

-592 

ER$ESA 

Bad address in ESA field 

Octal: 

Decimal: 

176650 

-600 

ER$ESL 

Bad value in ESL field 

Octal: 

Decimal: 

176644 

-604 

ER$ESS 

ESS field value too small 

Octal: 

Decimal: 

176640 

-608 

ER$EXP 

File expiration date not yet reached 

Octal: 

Decimal: 

176630 

-616 

ER$EXT 

File processor error 

Octal: 

Decimal: 

176620 

-624 

ER$FAC 

FAC field forbids operation 

Octal: 

Decimal: 

176560 

-656 

ER$FAL 

Operation not supported by remote node 

Octal: 

Decimal: 

176550 

-664 

ER$FEX 

File already exists 

Octal: 

Decimal: 

176540 

-672 
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ER$FID 

Bad value in FID field 

Octal: 

Decimal: 

177530 

-680 

ER$FLG 

Bad mask in FLG field 

Octal: 

Decimal: 

176520 

-688 

ER$FLK 

File locked by another task 

Octal: 

Decimal: 

176500 

-704 

ER$FNA 

Bad address in FNA field 

Octal: 

Decimal: 

176470 

-712 

ER$FND 

File processor error 

Octal: 

Decimal: 

176460 

-720 

ER$FNF 

File not found 

Octal: 

Decimal: 

176440 

-736 

ER$FNM 

Bad file name 

Octal: 

Decimal: 

176420 

-752 

ER$FOP 

Bad mask in FOP field 

Octal: 

Decimal: 

176400 

-768 

ER$FUL 

Device or file full 

Octal: 

Decimal: 

176360 

-784 

ER$IAN 

Bad value in IAN field 

Octal: 

Decimal: 

176340 

-800 

ER$IDX 

Index not initialized 

Octal: 

Decimal: 

176320 

-816 

ER$IFI 

Bad value in IFI field 

Octal: 

Decimal: 

176300 

-832 

ER$IMX 

Too many XABs of same type 

Octal: 

Decimal: 

176260 

-848 

ER$IOP 

Illegal operation for file 

Octal: 

Decimal: 

176220 

-880 

ER$IRC 

Illegal record found in sequential file 

Octal: 

Decimal: 

176200 

-896 

ER$ISI 

Bad value in ISI field 

Octal: 

Decimal: 

176160 

-912 

ER$KBF 

Bad address in KBF field 

Octal: 

Decimal: 

176140 

-928 
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ER$KEY 

Bad key 

Octal: 

Decimal: 

176120 

-944 

ER$KRF 

Bad value in KRF field 

Octal: 

Decimal: 

176100 

-960 

ER$KSZ 

Bad value in KSZ field 

Octal: 

Decimal: 

176060 

-976 

ER$LAN 

Bad value in LAN field 

Octal: 

Decimal: 

176040 

-992 

ER$LBL 

Bad magtape label 

Octal: 

Decimal: 

176020 

-1008 

ER$LBY 

Logical channel busy 

Octal: 

Decimal: 

176000 

-1024 

ER$LCH 

Bad value in LCH field 

Octal: 

Decimal: 

175760 

-1040 

ER$LEX 

Extension not needed 

Octal: 

Decimal: 

175750 

-1048 

ER$LOC 

Bad value in LOC field 

Octal: 

Decimal: 

175740 

-1056 

ER$MEM 

Memory address rollover 

Octal: 

Decimal: 

175710 

-1080 

ER$MKD 

File processor error 

Octal: 

Decimal: 

175700 

-1088 

ER$MRN 

Bad value in MRN field or bad record number 

Octal: 

Decimal: 

175660 

-1104 

ER$MRS 

Bad value in MRS field 

Octal: 

Decimal: 

175640 

-1120 

ER$NAE 

Unmappable network access error 

Octal: 

Decimal: 

175630 

-1128 

ER$NAM 

Bad address in NAM field 

Octal: 

Decimal: 

175620 

-1136 

ER$NEF 

Context not end-of-file 

Octal: 

Decimal: 

175600 

-1152 

ER$NET 

Network link lost 

Octal: 

Decimal: 

175570 

-1160 
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ER$NMF 

No more matching files 

Octal: 

Decimal: 

175554 

-1172 

ER$NOD 

Bad node name 

Octal: 

Decimal: 

175550 

-1176 

ER$NPK 

No primary key for indexed file 

Octal: 

Decimal: 

175540 

-1184 

ER$ORD 

Ordering of XABs illegal 

Octal: 

Decimal: 

175500 

-1216 

ER$ORG 

Bad mask in ORG field 

Octal: 

Decimal: 

175460 

-1232 

ER$PLG 

Error reading file prologue 

Octal: 

Decimal: 

175440 

-1248 

ER$PLV 

File prologue version level unsupported 

Octal: 

Decimal: 

175430 

-1256 

ER$POS 

Bad value in POS field 

Octal: 

Decimal: 

175420 

-1264 

ER$PRM 

Bad file date read 

Octal: 

Decimal: 

175400 

-1280 

ER$PRV 

Privilege violation 

Octal: 

Decimal: 

175360 

-1296 

ER$RAC 

Bad mask in RAC field 

Octal: 

Decimal: 

175320 

-1328 

ER$RAT 

Bad mask in RAT field 

Octal: 

Decimal: 

175300 

-1344 

ER$RBF 

Bad address in RBF field 

Octal: 

Decimal: 

175260 

-1360 

ER$RER 

File processor error 

Octal: 

Decimal: 

175240 

-1376 

ER$REX 

Record already exists 

Octal: 

Decimal: 

175220 

-1392 

ER$RFA 

Bad value in RFA field 

Octal: 

Decimal: 

175200 

-1408 

ER$RFM 

Bad code in RFM field 

Octal: 

Decimal: 

175160 

-1424 
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ER$RLK 

Record locked 

Octal: 

Decimal: 

175140 

-1440 

ER$RMV 

File processor error 

Octal: 

Decimal: 

175120 

-1456 

ER$RNF 

No such record 

Octal: 

Decimal: 

175100 

-1472 

ER$RNL 

Record not locked 

Octal: 

Decimal: 

175060 

-1488 

ER$ROP 

Bad mask in ROP field 

Octal: 

Decimal: 

175040 

-1504 

ER$RPL 

File processor error 

Octal: 

Decimal: 

175020 

-1520 

ER$RRV 

Bad internal pointer 

Octal: 

Decimal: 

175000 

-1536 

ER$RSL 

Bad value in RSL field 

Octal: 

Decimal: 

174754 

-1556 

ER$RSS 

Bad value in RSS field 

Octal: 

Decimal: 

174750 

-1560 

ER$RST 

Bad address in RSA field 

Octal: 

Decimal: 

174744 

-1564 

ER$RSZ 

Bad value in RSZ field 

Octal: 

Decimal: 

174740 

-1568 

ER$RTB 

Record too big for user buffer 

Octal: 

Decimal: 

174720 

-1584 

ER$RVU 

Internal pointer corrupted 

Octal: 

Decimal: 

174710 

-1592 

ER$SEQ 

Sequential insertion records not in order 

Octal: 

Decimal: 

174700 

-1600 

ER$SHR 

Bad mask in SHR field 

Octal: 

Decimal: 

174660 

-1616 

ER$SIZ 

Bad value in SIZ field 

Octal: 

Decimal: 

174640 

-1632 

ER$SUP 

Operation not supported over network 

Octal: 

Decimal: 

174610 

-1656 
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ER$SYS 

System error 

Octal: 

Decimal: 

174600 

-1664 

ER$TRE 

Index error 

Octal: 

Decimal: 

174560 

-1680 

ER$TYP 

Bad file extension 

Octal: 

Decimal: 

174540 

-1696 

ER$UBF 

Bad address in UBF field 

Octal: 

Decimal: 

174520 

-1712 

ER$UIN 

Field value rejected by FAL 

Octal: 

Decimal: 

174510 

-1720 

ER$USZ 

Bad value in USZ field 

Octal: 

Decimal: 

174500 

-1728 

ER$VER 

Bad file version number 

Octal: 

Decimal: 

174460 

-1744 

ER$WCD 

Illegal wildcard in merged string 

Octal: 

Decimal: 

174430 

-1768 

ER$WER 

File processor error 

Octal: 

Decimal: 

174420 

-1776 

ER$WLK 

Device write-locked 

Octal: 

Decimal: 

174410 

-1784 

ER$WPL 

File processor error 

Octal: 

Decimal: 

174400 

-1792 

ER$XAB 

Bad address in XAB field 

Octal: 

Decimal: 

174360 

-1808 

ER$XTR 

Extraneous data in file specification 

Octal: 

Decimal: 

174340 

-1824 
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FATAL ERROR CODES 


ER$ACT 

Illegal concurrent operation 

Octal: 

Decimal: 

177720 

-48 

ER$AST 

Illegal operation at AST level 

Octal: 

Decimal: 

177560 

-144 

ER$BUG 

Error in RMS-11 internal data 

Octal: 

Decimal: 

177360 

-272 

ER$CPB 

Bad parameter block 

Octal: 

Decimal: 

177230 

-360 

ER$FAB 

Bad FAB 

Octal: 

Decimal: 

176600 

-640 

ER$LIB 

Resident library not available 

Octal: 

Decimal: 

175744 

-1052 

ER$MAP 

Error in internal buffer mapping data 

Octal: 

Decimal: 

175720 

-1072 

ER$RAB 

Bad RAB 

Octal: 

Decimal: 

175340 

-1312 
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ASCII CHARACTER SET 


Octal 

Code 

Character 

Octal 

Code 

Character 

Octal 

Code 

Character 

Octal 

Code 

Character 

000 

NUL 

040 

SP 

100 

@ 

140 


001 

SOH 

041 

j 

101 

A 

141 

a 

002 

STX 

042 

ft 

102 

B 

142 

b 

003 

ETX 

043 

# 

103 

C 

143 

c 

004 

EOT 

044 

$ 

104 

D 

144 

d 

005 

ENQ 

045 

% 

105 

E 

145 

e 

006 

ACK 

046 

& 

106 

F 

146 

f 

007 

BEL 

047 

' 

107 

G 

147 

g 

010 

BS 

050 

( 

110 

H 

150 

h 

Oil 

HT 

051 

\ 

111 

1 

151 

1 

012 

LF 

052 


112 

J 

152 

j 

013 

VT 

053 

+ 

113 

K 

153 

k 

014 

FF 

054 


114 

L 

154 

1 

015 

CR 

055 

- 

115 

M 

155 

m 

016 

SO 

056 


116 

N 

156 

n 

017 

SI 

057 

/ 

117 

O 

157 

0 

020 

DLE 

060 

0 

120 

P 

160 

P 

021 

DC1 

061 

1 

121 

Q 

161 

q 

022 

DC2 

062 

2 

122 

R 

162 

r 

023 

DC3 

063 

3 

123 

S 

163 

s 

024 

DC4 

064 

4 

124 

T 

164 

t 

025 

NAK 

065 

5 

125 

U 

165 

u 

026 

SYN 

066 

6 

126 

V 

166 

V 

027 

ETB 

067 

7 

127 

w 

167 

w 

030 

CAN 

070 

8 

130 

X 

170 

X 

031 

EM 

071 

9 

131 

Y 

171 

y 

032 

SUB 

072 


132 

z 

172 

z 

033 

ESC 

073 

j 

133 

[ 

173 

{ 

034 

FS 

074 

< 

134 

\ 

174 

1 

035 

GS 

075 

= 

135 

] 

175 

} 

036 

RS 

076 

> 

136 

A 

176 


037 

US 

077 

? 

137 

— 

177 

DEL 


•Equivalent to the Radix-50 character set. 
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I/O ERROR CODES 


The table below lists RSX-11M I/O error codes. Only partial abbreviations (xxx) 
are listed; the complete abbreviation is IE.xxx. The octal number listed is the 
low-order byte of the complete word value (2’s complement of the decimal num¬ 
ber). 


Abbreviation 

Error 

Decimal 

Number 

Octal 

Meaning 

.BAD 

- 1 

377 

Bad parameters 

• IFC 

- 2 

376 

Invalid function code 

.DNR 

- 3 

375 

Device not ready 

.VER 

- 4 

374 

Parity error on device 

.ONP 

- 5 

373 

Hardware option not present 

.SPC 

- 6 

372 

Illegal user buffer 

.DNA 

- 7 

371 

Device not attached 

.DAA 

- 8 

370 

Device already attached 

.DUN 

- 9 

367 

Device not attachable 

.EOF 

-10 

366 

End-of-file detected 

.EOV 

-11 

365 

End-of-volume detected 

.WLK 

-12 

364 

Write attempted to locked unit 

.DAO 

-13 

363 

Data overrun 

.SRE 

-14 

362 

Send/receive failure 

.ABO 

-15 

361 

Request terminated 

.PRI 

-16 

360 

Privilege violation 

.RSU 

-17 

357 

Shareable resource in use 

.OVR 

-18 

356 

Illegal overlay request 

.BYT 

-19 

355 

Odd byte count (or virtual address) 

.BLK 

-20 

354 

Logical Block Number too large 

.MOD 

-21 

353 

Invalid UDC module number 

.CON 

-22 

352 

UDC connect error 

.NOD 

-23 

351 

Caller’s nodes exhausted 

.DFU 

-24 

350 

Device full 

.IFU 

-25 

347 

Index file full 

.NSF 

-26 

346 

No such file 

.LCK 

-27 

345 

Locked from read/write access 

.HFU 

-28 

344 

File header full 

.WAC 

-29 

343 

Accessed for write 

.CKS 

-30 

342 

File header checksum failure 

.WAT 

-31 

341 

Attribute control list format error 

.RER 

-32 

340 

File processor device read error 
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I/O Error Codes 



Error 

Number 

Abbreviation 

Decimal 

Octal 

.WER 

-33 

337 

.ALN 

-34 

336 

.SNC 

-35 

335 

.SQC 

-36 

334 

.NLN 

-37 

333 

.CLO 

-38 

332 

.NBF 

-39 

331 

.RBG 

-40 

330 

.NBK 

-41 

327 

.ILL 

-42 

326 

.BTP 

-43 

325 

.RAC 

-44 

324 

.RAT 

-45 

323 

.RCN 

-46 

322 

.ICE 

-47 

321 

.2DV 

-48 

320 

.FEX 

-49 

317 

.BDR 

-50 

316 

.RNM 

-51 

315 

.BDI 

-52 

314 

.FOP 

-53 

313 

.BNM 

-54 

312 

.BDV 

-55 

311 

.BBE 

-56 

310 

.DUP 

-57 

307 

.STK 

-58 

306 

.FHE 

-59 

305 

.NFI 

-60 

304 

.ISO 

-61 

303 

.EOT 

-62 

302 

.BVR 

-63 

301 

.BHD 

-64 

300 

.OFL 

-65 

277 

.BCC 

-66 

276 

.ONL 

-67 

275 

.NNN 

-68 

274 

.NFW 

-69 

273 

.DIS 

-69 

273 

.BLB 

-70 

272 

.TMM 

-71 

271 

.NDR 

-72 

270 


Meaning 

File processor device write error 
File already accessed on LUN 
File ID, file number check 
File ID, sequence number check 
No file accessed on LUN 
File was not properly closed 
No buffer space available for file 
Illegal record size 

File exceeds space allocated, no blocks 
Illegal operation on file descriptor block 
Bad record type 
Illegal record access bits set 
Illegal record attribute bits set 
Illegal record number-too large 
Internal consistency error 
Rename-two different devices 

Rename-a new file name already in use 

Bad directory file 

Cannot rename old file system 

Bad directory syntax 

File already open 

Bad file name 

Bad device name 

Bad block on device 

Enter-duplicate entry in directory 
Not enough stack space (FCS or FCP) 
Fatal hardware error on device 
File ID was not specified 
Illegal sequential operation 
End-of-tape detected 
Bad version number 
Bad file header 

Device off line 

Block check, CRC, or framing error 

Device on line 

No such node 

Path lost to partner 

Path lost to partner 

Bad logical buffer 

Too many outstanding messages 

No dynamic space available 
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I/O Error Codes 



Error 

Number 


Abbreviation 

Decimal 

Octal 

Meaning 

.URJ 

-73 

267 

Connection rejected by user 

.NRJ 

-74 

266 

Connection rejected by network 

.EXP 

-75 

265 

File expiration date not reached 

.BTF 

-76 

264 

Bad tape format 

.NNC 

-77 

263 

Not ANSI “D” format byte count 

.NDA 

-78 

262 

No data available 

.NLK 

-79 

261 

Task not linked to specified ICS/ICR in¬ 
terrupts 

.NST 

-80 

260 

Specified task not installed 

.AST 

-80 

260 

No AST specified in connect 

.FLN 

-81 

257 

Device off line when off-line request was 
issued 

.IES 

-82 

256 

Invalid escape sequence 

.PES 

-83 

255 

Partial escape sequence 

.ALC 

-84 

254 

Allocation failure 

.ULK 

-85 

253 

Unlock error 

.WCK 

-86 

252 

Write check failure 

.NTR 

-87 

251 

Task not triggered 

.REJ 

-88 

250 

Transfer rejected by receiving CPU 

.FLG 

-89 

247 

Event flag already specified 

.DSQ 

-90 

246 

Disk quota exceeded 

.IQU 

-91 

245 

Inconsistent qualifier usage 

.RES 

-92 

244 

Circuit reset during operation 

.TML 

-93 

243 

Too many links to task 

.NNT 

-94 

242 

Not a network task 

.TMO 

-95 

241 

Timeout on request 

.CNR 

-96 

240 

Connection rejected 

.UKN 

-97 

237 

Uknown name 

.SZE 

-98 

236 

Unable to size device 

.Mil 

-99 

235 

Media inserted incorrectly 

.SPI 

-100 

234 

Spindown ignored 


For additional information, refer to the IAS/RSX-11 I/O Operations Reference 
Manual. 
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DIRECTIVE ERROR CODES 


Directives in the Directive Status Word ($DSW) return the following error 
codes. The complete abbreviation for these codes is IE.xxx. Only partial abbre¬ 
viations (xxx) are included in this list. The octal error number listed is the low- 
order byte of the complete word value (2’s complement of the decimal). 



Error 

Number 

breviation 

Decimal 

Octal 

.UPN 

- 1 

377 

.INS 

- 2 

376 

.PTS 

- 3 

375 

.UNS 

- 4 

374 

.ULN 

- 5 

373 

.HWR 

- 6 

372 

.ACT 

- 7 

371 

.ITS 

- 8 

370 

.FIX 

- 9 

367 

.CKP 

-10 

366 

.TCH 

-11 

365 


-12 



-14 


.RBS 

-15 

361 

.PRI 

-16 

360 

.RSU 

-17 

357 

.NSW 

-18 

356 

.ILV 

-19 

355 

.ITN 

-20 

354 

.LNF 

-21 

353 


-79 


.AST 

-80 

260 

.MAP 

-81 

257 


-82 

256 

.IOP 

-83 

255 

.ALG 

-84 

254 

.WOV 

-85 

253 

.NVR 

-86 

252 

.NVW 

-87 

251 

.ITP 

-88 

250 


Meaning 

Insufficient dynamic storage 
Specified task not installed 
Partition too small for task 
Insufficient dynamic storage for send 
Unassigned LUN 
Device driver not resident 
Task not active 

Directive inconsistent with task state 
Task already fixed/unfixed 
Issuing task not checkpointable 
Task is checkpointable 
(reserved) 

(reserved) 

Receive buffer too small 
Privilege violation 
Resource in use 
No swap space available 
Illegal vector specified 
Invalid table number 
Logical name not found 

(reserved) 

Directive issued/not issued from AST 
Illegal mapping specified 
(reserved) 

Window has I/O in progress 
Alignment error 

Address window allocation overflow 
Invalid region ID 
Invalid address window ID 
Invalid TI parameter 


171 



Directive Error Codes 



Error 

Number 


Abbreviation 

Decimal 

Octal 

Meaning 

.IBS 

-89 

247 

Invalid send buffer size (greater 
than 255) 

.LNL 

-90 

246 

LUN locked in use 

.IUI 

-91 

245 

Invalid UIC 

.IDU 

-92 

244 

Invalid device or unit 

.ITI 

-93 

243 

Invalid time parameters 

.PNS 

-94 

242 

Partition/region not in system 

.IPR 

-95 

241 

Invalid priority (greater than 250) 

.ILU 

-96 

240 

Invalid LUN 

.IEF 

-97 

237 

Invalid event flag (greater than 64) 

.ADP 

-98 

236 

Part of DPB out of user’s space 

.SDP 

-99 

235 

DIC or DPB size invalid 

For additional 

information, 

refer to 

the RSX-11M/M-PLUS Executive 


Reference Manual. 
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EXECUTIVE DIRECTIVE SUMMARY IN 
ALPHABETICAL ORDER BY MACRO CALL 


Abort Task 

FORTRAN Call: 

CALL ABORT (tsk[,ids]) 


tsk = 

Name of task to be aborted (Radix-50) 

ids = 

Directive status 

Macro Call: 


ABRT$ 

tsk 

tsk = 

Name of task to be aborted (Radix-50) 

Alter Priority 


FORTRAN Call: 

CALL ALTPRI ([tsk],[ipri][,ids]) 

tsk = 

Active task name 

ipri = 

A 1-word integer value equal to the new priority, 
(decimal) 

ids = 

Directive status 

Macro Call: 


ALTP$ [tsk] [,pri] 

tsk = 

Active task name 

pri = 

New priority, from 1 to 250 (decimal) 


Assign LUN 

FORTRAN Call: 

CALL ASNLUN (lun,dev,unt[,ids]) 
lun = Logical unit number 
dev = Device name (format: 1A2) 
unt = Device unit number 
ids = Directive status 


ABRT$ 


ALTP$ 


from 1 to 250 


ALUN$ 
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Executive Directive Summary in Alphabetical Order by Macro Call 


Macro Call: 

ALUN$ lun,dev,unt 

lun = Logical unit number 

dev = Device name (two characters) 

unt = Device unit number 

AST Service Exit ($S form recommended) ASTX$S 

FORTRAN Call: 

Neither the FORTRAN language nor the ISA standard permits direct linking 
to system-trapping mechanisms; therefore, this directive is not available to 
FORTRAN tasks. 

Macro Call: 

ASTX$S [err] 

err = Error routine address 

Attach Region ATRG$ 

FORTRAN Call: 

CALL ATRG (irdb[,ids]) 

irdb = An 8-word integer array containing a Region Definition Block 
(see Section 3.5.1.2) 

ids = Directive status 

Macro Call: 

ATRG$ rdb 

rdb = Region Definition Block address 

Connect To Interrupt Vector CINT$ 

FORTRAN Call: 

Not supported 
Macro Call: 

CINT$ vec,base,isr,edir,pri,ast 

vec = Interrupt vector address — Must be in the range 60(8) to high¬ 
est vector specified during SYSGEN, inclusive, and must be a 
multiple of 4 
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Executive Directive Summary in Alphabetical Order by Macro Call 


base = Virtual base address for kernel APR 5 mapping of the ISR, and 
enable/disable interrupt routines 

isr = Virtual address of the ISR, or 0 to disconnect from the inter¬ 
rupt vector 

edir = Virtual address of the enable/disable interrupt routine 

pri = Initial priority at which the ISR is to execute 

ast = Virtual address of an AST routine to be entered after the fork- 
level routine queues an AST 

Clear Event Flag CLEFS 

FORTRAN Call: 

CALL CLREF (efn[,idsl) 

efn = Event flag number 
ids = Directive status 
Macro Call: 

CLEFS efn 

efn = Event flag number 

Cancel Mark Time Requests CMKTS 

FORTRAN Call: 

CALL CANMT ([efn][,ids]) 
efn = Event flag number 
ids = Directive status 
Macro Call: 

CMKT$ [efn, ast,err] 


efn = 

Event flag number 


ast = 

Mark time AST address 


err = 

Error routine address 


Connect 


CNCTS 


FORTRAN Call: 

CALL CNCT (rtname,[iefn],[iast],[iesb],[iparm][,ids]) 

rtname = Name (Radix-50) of the offspring task to be connected 
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Executive Directive Summary in Alphabetical Order by Macro Call 


iefn 

iast 

iesb 


iparm 

ids 

Macro Call: 


Event flag to be set when the offspring task exits or emits 
status 

Name of an AST routine to be called when the offspring task 
exits or emits status 

Name of an 8-word status block to be written when the 
offspring task exits or emits status 

Word 0 — Offspring task exit status 

Word 1-7 — Reserved 

Name of a word to receive the status block address when an 
AST occurs 

Integer to receive the Directive Status Word 


CNCT$ tname, [efn], [east], [esb] 

tname = Name (Radix-50) of the offspring task to be connected 

efn = The event flag to be cleared on issuance and set when the 

offspring task exits or emits status 

east = Address of an AST routine to be called when the offspring 
task exits or emits status 

es b = Address of an 8-word status block to be written when the 

offspring task exits or emits status 

Word 0 — Offspring task exit status 

Word 1-7 — Reserved 


Create Address Window CRAW$ 

FORTRAN Call: 

CALL CRAW (iwdb[,ids]) 

iwdb = An 8-word integer array containing a Window Definition Block 
(see Section 3.5.2.2) 

ids = Directive status 

Macro Call: 

CRAW$ wdb 

wdb = Window Definition Block address 
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Executive Directive Summary in Alphabetical Order by Macro Call 


Create Group Global Event Flags CRGF$ 

FORTRAN Call: 

CALL CRGF ([group][,ids]) 

group = Group number for the flags to be created — If not specified, 
the task’s protection UIC (H.CUIC+1) in the task’s header is 
used 

ids = Integer to receive the Directive Status Word 
Macro Call: 

CRGF$ [group] 

group = Group number for the flags to be created — If not specified, 
the task’s protection UIC (H.CUIC+1) in the task’s header is 
used 

Create Region CRRG$ 

FORTRAN Call: 

CALL CRRG (irdb[,idsl) 

irdb = An 8-word integer array containing a Region Definition Block 
(see Section 3.5.1.2) 

ids = Directive status 

Macro Call: 

CRRG$ rdb 

rdb = Region Definition Block address 

Cancel Time-Based Initiation Requests CSRQ$ 

FORTRAN Call: 

CALL CANALL (tsk[,idsl) 
tsk = Task name 

ids = Directive status 

Macro Call: 

CSRQ$ tsk 

tsk = Task name 
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Declare Significant Event ($S form recommended) DECL$S 

FORTRAN Call: 

CALL DECLAR ([.ids]) 
ids = Directive status 
Macro Call: 

DECL$S [,err] 

err = Error routine address 

Disable AST Recognition ($S form recommended) DSAR$S 

FORTRAN Call: 

CALL DSASTR [(ids)] 
ids = Directive status 
Macro Call: 

DSAR$S [err] 

err = Error routine address 

Disable Checkpointing ($S form recommended) DSCP$S 

FORTRAN Call: 

CALL DISCKP [(ids)] 
ids = Directive status 
Macro Call: 

DSCP$S [err] 

err = Error routine address 

Detach Region DTRG$ 

FORTRAN Call: 

CALL DTRG (irdbl.ids]) 

irdb = An 8-word integer array containing a Region Definition Block 
(see Section 3.5.1.2) 

ids = Directive status 

Macro Call: 

DTRG$ rdb 

rdb = Region Definition Block address 
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Eliminate Address Window ELAW$ 

FORTRAN Call: 

CALL ELAW (iwdb[,idsl) 

iwdbi = An 8-word integer array containing a Window Definition 
Block (see Section 3.5.2.2) 

ids = Directive status 

Macro Call: 

ELAW$ wdb 

wdb = Window Definition Block address 

Eliminate Group Global Event Flags ELGF$ 

FORTRAN Call: 

CALL ELGF ([group]!,ids]) 

group = Group number of flags to be eliminated 

ids = Integer to receive the Directive Status Word 

Macro Call: 

ELGF$ [group] 

group = Group number of flags to be eliminated 

Emit Status EMST$ 

FORTRAN Call: 

CALL EMST ([rtname],istat[,ids]) 

rtname = Name of task connected to issuing task to which the status 
is to be emitted 

istat = A 16-bit quantity to be returned to the connected task 

ids = Integer to receive the Directive Status Word 

Macro Call: 

EMST$ [tname],status 

tname = Name of a task connected to the issuing task to which the 
status is to be emitted 

status = A 16-bit quantity to be returned to the connected task 
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Enable AST Recognition ($S form recommended) ENAR$S 

FORTRAN Call: 

CALL ENASTR [(ids)] 
ids = Directive status 
Macro Call: 

ENAR$S [err] 

err = Error routine address 

Enable Checkpointing ($S form recommended) ENCP$S 

FORTRAN Call: 

CALL ENACKP [(ids)] 
ids = Directive status 
Macro Call: 

ENCP$S [err] 

err = Error routine address 

Exit lf EXIFS 

FORTRAN Call: 

CALL EXITIF (efn[,ids]) 
efn = Event flag number 
ids = Directive status 
Macro Call: 

EXIF$ efn 

efn = Event flag number 

Task Exit ($S form recommended) EXIT$S 

FORTRAN Call: 

Fortran tasks that terminate with the STOP statement result in a message 
that includes task name, a statement causing the task to stop, and an op¬ 
tional character string specified in the STOP statement. CALL EXIT termi¬ 
nates with the message STOP THIS FORTRAN TASK. 

Macro Call: 

EXIT$S [err] 

err = Error routine address 
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Exit With Status EXST$ 

FORTRAN Call: 

CALL EXST (istat) 

istat = A 16-bit quantity to be returned to parent task 

Macro Call: 

EXST$ status 

status = A 16-bit quantity to be returned to parent task 

Extend Task EXTK$ 

FORTRAN Call: 

CALL EXTTSK ([inc][,ids]) 

inc = A positive or negative number equal to the number of 32-word 
blocks by which the task size is to be extended or reduced (If 
omitted, task size defaults to installed task size.) 

ids = Directive status 

Macro Call: 

EXTK$ [incj 

inc = A positive or negative number equal to the number of 32-word 
blocks by which the task is to be extended or reduced (If omit¬ 
ted, task size defaults to installed task size.) 


Get Command for Command Interpreter 

Fortran Call: 

CALL GTCMCI (icbf,icbfl,[iibuf],[iibfl],tiaddr],[incp]t,ids]) 

icbf = Name of a byte to receive the command 

icbfl = Integer containing the size of the icbf array in 

iibuf = Name of an integer containing the length of the 
mation buffer 

iibfl = Name of an integer containing the length of the 
mation buffer 

iaddr = Name of an integer that contains the address 
command desired (This address was obtained 
call to GTCMCI with GC.CND specified.) 


GCCI$ 


bytes 

optional infor- 

optional infor- 

in pool of the 
by a previous 
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incp = 

Name of an integer containing a value indicating the action to 
take if there is no command queued 

ids = 

Integer to receive the directive status word 

Macro Call: 



GCCI$ cbuf,cbfl,[ibufl,[ibfl],[addr],[ncp] 

cbuf = Address of buffer to receive command string 


cbfl 

Length of buffer. Maximum buffer size is 84. for RSX-11M 
and 259. for RSX-11M-PLUS. 

ibuf = 

Address of buffer to receive information on the issuing termi¬ 
nal 

ibfl 

Length of buffer to receive information 

addr = 

Address of command 

ncp = 

Action to take if no command buffer is present 

GC.CCS (000) — Return with carry set (default) 

GC.CEX (001) — Force CLI to exit instead of returning 

GC.CST (002) — Force CLI to stop instead of return¬ 
ing 

GC.CND (200) — Copy command into buffer but do 
not dequeue it from the list 


Get Command Interpreter Information GCII$ 

FORTRAN Call: 

CALL GETCII (ibuf,ibfl,[icli],[idev],[iunit][,ids] 

ibuf = Name of an integer array to receive the CLI information 


ibfl = 

Length in bytes of the integer array to receive the CLI informa¬ 
tion 

icli = 

Name of a two-word array element containing the RAD50 
name of the CLI 

idev = 

Name of an integer containing the ASCII name of terminal 
(default = TI:) 
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iunit 

Name of an integer containing the octal unit number of termi¬ 
nal 

ids 

Directive status 


Macro Call: 

GCII$ buf,bufl,cli,[dev],[unit] 


buf 

Address of buffer to receive information 

bufl 

Length of information buffer 

cli = 

= Name in RAD50 of the CLI that information is requested on 

dev 

ASCII name of terminal whose CLI should be used 

unit 

= Octal unit number of terminal 


Get LUN Information GLUN$ 

FORTRAN Call: 

CALL GETLUN (lun,dat[,ids]) 


lun = 

Logical unit number 

dat = 

A 6-word integer array to receive LUN information 

ids = 

Directive status 


Macro Call: 

GLUN$ lun,buf 


lun = 

Logical unit number 

buf = 

Address of 6-word buffer that will receive the LUN information 


Get MCR Command Line GMCR$ 

FORTRAN Call: 

CALL GETMCR (buf[,idsl) 


buf = 

An 80-byte array to receive command line 

ids = 

Directive status 

Macro Call: 


GMCR$ 



183 




Executive Directive Summary in Alphabetical Order by Macro Call 


Get Mapping Context GMCX$ 

FORTRAN Call: 

CALL GMCX (imcx[,ids)) 

imcx = An integer array to receive the mapping context. The size of 
the array is 8*n+l, where n is the number of window blocks in 
the task’s header (The maximum size is 8*8+1=65 on 
RSX-11M systems. The maximum size is 8*24+1=193 on 
RSX-11M-PLUS systems.) 

ids = Directive status 
Macro Call: 

GMCX$ wvec 

wvec = The address of a vector of n Window Definition Blocks; n is the 
number of window blocks in the task’s header. 

Get Partition Parameters GPRT$ 

FORTRAN Call: 

CALL GETPAR ([prt],buf[,ids]) 
prt = Partition name 

buf = A 3-word integer array to receive partition parameters 
ids = Directive status 
Macro Call: 

GPRT$ [prt],buf 

prt = Partition name 

buf = Address of 3-word buffer 

Get Region Parameters GREG$ 

FORTRAN Call: 

CALL GETREG ([rid],buf[,ids]) 
rid = Region id 

buf = A 3-word integer array to receive region parameters 
ids = Directive status 
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Macro Call: 

GREG$ [rid], buf 
rid = Region ID 
buf = Address of 3-word buffer 

Get Sense Switches ($S form recommended) GSSW$S 

FORTRAN Call: 

CALL READSW (isw) 

isw = Integer to receive the console switch settings 

The following FORTRAN call allows a program to read the state of a single 
switch: 

CALL SWITCH (ibt,ist) 

ibt = The switch to be tested (0 to 15) 
ist = Test results where: 

1 = switch on 

2 = switch off 

Macro Call: 

GSSW$S [err] 

err = Error routine address 

Get Time Parameters GTIM$ 

FORTRAN Call: 

CALL GETTIM (ibfl[,ids]) 

ibfl = An 8-word integer array 
ids = Directive status 
Macro Call: 

GTIM$ buf 

buf = Address of 8-word buffer 
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Get Task Parameters GTSK$ 

FORTRAN Call: 

CALL GETTSK (bufl.idsl) 

buf = A 16-word integer array to receive the task parameters 
ids = Directive status 
Macro Call: 

GTSK$ buf 

buf = Address of 16-word buffer 

Inhibit AST Recognition ($S form recommended) IHAR$S 

FORTRAN Call: 

CALL INASTR [(ids)] 
ids = Directive status 
Macro Call: 

IHAR$S [err] 

err = Error routine address 

Map Address Window MAP$ 

FORTRAN Call: 

CALL MAP (iwdb[,ids]) 

iwdb = An 8-word integer array containing a Window Definition Block 
(see Section 3.5.2.2) 

ids = Directive status 

Macro Call: 

MAP$ wdb 

wdb = Window Definition Block address 

Mark Time MRKT$ 

FORTRAN Call: 

CALL MARK (efn,tmg,tnt[,ids]) 
efn = Event flag number 
tmg = Time interval magnitude 
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tnt 

Time interval unit 

ids 

Directive status 


The ISA standard call for delaying a task for a specified time interval is also 
included: 

CALL WAIT (tmg,tnt,ids) 


tmg = 

Time interval magnitude 

tnt = 

Time interval unit 

ids = 

Directive status 

Macro Call: 



MRKT$ [efn],tmg,tnt[,ast] 


efn = 

Event flag number 

tmg = 

Time interval magnitude 

tnt = 

Time interval unit 

ast = 

AST entry point address 


Queue I/O Request QIO$ 

FORTRAN Call: 

CALL QIO (fnc,lun, [efn], [pri], [isb], [prl] [,ids]) 


fuc = 

I/O function code 

lun = 

Logical unit number 

efn = 

Event flag number 

pri = 

Priority; ignored, but must be present 

isb = 

A 2-word integer array to receive final I/O status 

prl = 

A 6-word integer array containing device-dependent parameters 
to be placed in parameter words 1 through 6 of the Directive 
Parameter Block (DPB). Fill in this array by using the 
GETADR routine (see Section 1.5.1.4). 

ids = 

Directive status 


Macro Call: 

QIO$ fnc,lun, [efn], [pri], [isb], [ast], [prl] 


fnc = 

I/O function code 

lun = 

Logical unit number 
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efn = Event flag number 

pri = Priority; ignored, but must be present 

isb = Address of I/O status block 

ast = Address of AST service routine entry point 

prl = Parameter list of the form <pl,...p6> 

Queue I/O Request And Wait QIOW$ 

FORTRAN Call: 

CALL WTQIO (fnc,lun,[efn], [pri],[isb], [prl] [,ids]) 


fnc 

= 

I/O function code 

lun 

= 

Logical unit number 

efn 

= 

Event flag number 

pri 

= 

Priority; ignored, but must be present 

isb 

= 

A 2-word integer array to receive final I/O status 

prl 

= 

A 6-word integer array containing device dependent parameters 
to be placed in parameter words 1 through 6 of the DPB 

ids 

= 

Directive status 

Macro Call: 


QIOW$ 

fnc, lun, [efn], [pri], [isb], [ast] [,prl] 

fnc 

= 

I/O function code 

lun 

= 

Logical unit number 

efn 

= 

Event flag number 

pri 

= 

Priority; ignored, but must be present 

isb 

= 

Address of I/O status block 

ast 

= 

Address of AST service routine entry point 

prl 

= 

Parameter list of the form <pl,...p6> 


Receive Data Or Stop RCST$ 

FORTRAN Call: 

CALL RCST ([rtname],ibuf[,ids]) 

rtname = Sender task name (If not specified, data may be received 
from any task.) 
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ibuf = Address of 15-word buffer to receive the sender task name 
and data 

ids = Integer to receive the Directive Status Word 
Macro Call: 

RCST$ [tname],buf 

tname = Sender Task name (If not specified, data may be received 
from any task.) 

buf = Address of a 15-word buffer to receive the sender task name 
and data 

Receive Data RCVD$ 

FORTRAN Call: 

CALL RECEIV ([tsk], buf [„ ids]) 

tsk = Sender task name (If not specified, data may be received from 
any task.) 

buf = A 15-word integer array for received data 
ids = Directive status 
Macro Call: 

RCVD$ [tsk],buf 

tsk = Sender task name (If not specified, data may be received from 
any task.) 

buf = Address of 15-word buffer 

Receive Data Or Exit RCVX$ 

FORTRAN Call: 

CALL RECOEX ([tsk],buf[„ids]) 

tsk = Sender task name (If not specified, data may be received from 
any task.) 

buf = A 15-word integer array for received data 
ids = Directive status 
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Macro Call: 

RCVX$ [tsk],buf 

tsk = Sender task name (If not specified, data may be received from 
any task.) 

buf = Address of 15-word buffer 

Read All Event Flags RDAF$ 

FORTRAN Call: 

A FORTRAN task can only read a single event flag. The call is: 

CALL READEF (efn[,idsl) 

efn = Event flag number (1-64.) 

ids = Directive status 

Macro Call: 

RDAF$ buf 

buf = Address of 4-word buffer 

Read Extended Event Flags RDXF$ 

FORTRAN Call: 

A FORTRAN task can read only a single event flag. The call is: 

CALL READEF (efn[,ids]) 

efn = Event flag number (1-96.) 

ids = Directive status 

Macro Call: 

RDXF$ buf 

buf = Address of 6-word buffer 

Request and Pass Offspring Information RPOI$ 

FORTRAN Call: 

CALL RPOI (tname,[iugc],[iumc],[iparen],[ibuf|,[ibfl],[isc], 

[idnam], [iunit], [itask], [ocbad] [, ids]) 

tname = An array containing the actual name of the task to be re¬ 
quested and optionally chained to 

iugc = Integer containing the group code number for the UIC of the 
requested target chain task 
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iumc 

— 

Integer containing the member code number for the UIC of 
the requested target chain task 

iparen 

= 

Array (or 1*4 integer) containing the Radix-50 name of the 
parent task (This is returned in the information buffer of the 
GTCMCI subroutine.) 

ibuf 

= 

Array that contains the command line text for the chained 
task. 

ibfl 

= 

Integer that contains the number of bytes in the command in 
the ibuf array 

isc 

= 

Flag byte controlling the actions of this directive request 
when executed. The bit definitions of this byte are as follows: 



RP.OEX = 128. Force this task to exit on successful ex¬ 
ecution of the RPOI directive. 



RP.OAL = 1 Pass all of this task’s OCB’s to the re¬ 
quested task. (Default is none.) 

idnam 

= 

Integer containing the ASCII device name of the requested 
tasks TI: 

iunit 

= 

Integer containing the unit number of the requested tasks 
TI: device 

itask 

= 

Array which contains the Radix-50 name the requested task 
is to run under. (Valid only for CLIs.) 

ocbad 


Integer containing the internal pool address of the parent 
OCB (Only a CLI can specify this argument because the 
value can only be obtained in the information buffer of the 
GTCMCI subroutine.) 

ids 

= 

Integer to receive the directive status word 

Macro Call: 




RPOI$ tname,pn,pr,ugc,umc,parent,bufadr,buflen,sc,dnam,unit,task,ocbad 

tname = Name of task to be chained to 

pn = Partition name (Not used or supported) 

pr = Request priority (Not used or supported) 

ugc = Group code for UIC of the requested task 

umc = Member code for UIC of the requested task 

parent = Name of issuing task’s parent task whose OCB is to be 

passed. If not specified, all OCB’s are passed. 
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bufadr 

= Address of buffer to be given to the requested task 


buflen 

= Length of buffer to be given to requested task 


sc 

= Flags byte: 



RP.OEX — (200) Force issuing task to exit 
RP.OAL — (1) Pass all OCB’s 


dnam 

= ASCII device name for TI: 


unit 

= Unit number of task TI: 


task 

= Radix-50 name of task to be started 


ocbad 

= Address of OCB to pass (CLIs only) 


Request Task 

RQST$ 

FORTRAN Call: 


CALL REQUES (tsk, [opt][,ids]) 


tsk 

= Task name 


opt 

= A 4-word integer array 



opt(l) = Partition name first half; ignored, but 
present 

must be 


opt(2) = Partition name second half; ignored, but must be 
present 


opt(3) = Priority; ignored, but must be present 

opt(4) = User Identification Code 


ids 

= Directive status 


Macro Call: 



RQST$ 

tsk, [prt], [pri][,ugc,umc] 


tsk 

= Task name 


prt 

= Partition name; ignored, but must be present 


pri 

= Priority; ignored, but must be present 


ugc 

= UIC group code 


umc 

= UIC member code 
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Receive By Reference RREF$ 

FORTRAN Call: 

CALL RREF (iwdb,[isrb][,ids]) 

iwdb = An 8-word integer array containing a Window Definition Block 
(see Section 3.5.2.2) 

isrb = A 10-word integer array to be used as the receive buffer 
ids = Directive status 
Macro Call: 


RREF$ wdb 

wdb = Window Definition Block 

Resume Task RSUM$ 

FORTRAN Call: 

CALL RESUME (tsk[,idsl) 


tsk = Task name 
ids = Directive status 

Macro Call: 


RSUM$ tsk 


tsk = Task name 

Run Task RUNS 

FORTRAN Call: 

CALL RUN (tsk,[opt],[smg],snt,[rmg],[rnt][,ids]) 

tsk = Task name 

opt = A 4-word integer array 

opt(l) = Partition name first half; ignored, but must be 
present 

opt(2) = Partition name second half; ignored, but must be 
present 

opt(3) = Priority; ignored, but must be present 
opt(4) = User Identification Code 
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smg 

= 

Schedule delta magnitude 

snt 

= 

Schedule delta unit 

rmg 

= 

Reschedule interval magnitude 

mt 

= 

Reschedule interval unit 

ids 

= 

Directive status 

The ISA standard call for initiating a task is also included: 

CALL START (tsk,smg,snt[,ids]) 

tsk 

= 

Task name 

smg 

= 

Schedule delta magnitude 

snt 

= 

Schedule delta unit 

ids 

= 

Directive status 

Macro Call: 


RUN$ 

tsk, [prt], [pri], [ugc], [umc], [smg] ,snt[,rmg, mt] 

tsk 

= 

Task name 

prt 

= 

Partition name; ignored, but must be present 

pri 

= 

Priority; ignored, but must be present 

ugc 

= 

UIC group code 

umc 

= 

UIC member code 

smg 

= 

Schedule delta magnitude 

snt 

= 

Schedule delta unit 

rmg 

= 

Reschedule interval magnitude 

mt 

= 

Reschedule interval unit 


Specify Command Arrival AST SCAA$ 

FORTRAN Call: 

Not supported 
Macro Call: 

SCAA$ [ast] 

ast = AST service routine entry point; omitting this parameter dis¬ 
ables command arrival ASTs for the issuing CLI task until the 
directive is specified again. 
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Set Command Line Interpreter SCLI$ 

FORTRAN Call: 

CALL SETCLI (icli,idev,iunit[,ids]) 


icli = 

A two word array element containing the name of the CLI to 
which the terminal is to be set 

idev = 

Integer containing the ASCII name of the terminal to be set 
(default = TI:) 

iunit = 

Integer containing the unit number of terminal 

ids = 

Directive status 

Macro Call: 


SCLI$ cli,[dev],[unit] 

cli = 

Name of the CLI to which the terminal is to be set 

dev = 

ASCII name of the terminal to be set (default = TI:) 

unit = 

Unit number of terminal 

Send Data 

SDAT$ 

FORTRAN Call: 

CALL SEND (tsk,buf,[efn][,ids]) 

tsk = 

Task name 

buf = 

A 13-word integer array of data to be sent 

efn = 

Event flag number 

ids = 

Directive status 

Macro Call: 


SDAT$ tsk,buf[,efn] 

tsk = 

Task name 

buf = 

Address of 13-word data buffer 

efn = 

Event flag number 


Send Data Request and Pass Offspring Control Block SDRP$ 

FORTRAN Call: 

CALL SDRP (task,ibuf, [ibfl], [iefn], [iflag], [iparenl, [iocbad] [,ids]) 

task = Name of an array (REAL, INTEGER, 1*4) that contains the 
Radix-50 name of target task 
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ibuf 

= 

Integer array containing data to be sent 

ibfl 


Integer containing number of words (integers) in the array to 
be sent (On RSX-11M systems, this argument must be 13., 
and on RSX-11M-PLUS systems, this argument may be in 
the range of 1 to 255.) (Default = 13.) 

iefn 

= 

Integer containing the number of the event flag to be set 
when this directive is executed successfully 

iflag 

= 

Integer containing flags bits controlling the execution. They 
are defined as follows: 



SD.REX = 128. Force this task to exit upon successful 
execution 



SD.RAL = 1 Pass all OCBs 

iparen 

= 

Name of array containing the Radix-50 name of the parent 
task whose OCB should be passed to the target task 

iocbad 

= 

Name of an integer containing internal pool address of the 
OCB to pass 

ids 

= 

Integer to receive the contents of the Directive Status Word 

Macro Call: 



SDRP$ task,bufadr,buflen,efn,flag,parent,ocbad 

task 

= 

Name of task to be chained to 

bufadr 

= 

Address of buffer to be given to the requested task 

buflen 

= 

Length of buffer to be given to requested task 

efn 

= 

Event flag 

flag 

= 

Flags byte (Force exit, pass all OCB’s) 

parent 

= 

Name of issuing task’s parent task whose OCB is to be 
passed 

ocbad 

= 

Address of OCB to pass (CLI’s only) 


Send, Request And Connect SDRC$ 

FORTRAN Call: 

CALL SDRC (rtname,ibuf,[iefn],[iast],[iesb],[iparm][,ids]) 

rtname = Target task name of the offspring task to be connected 
ibuf = Name of 13-word send buffer 
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iefn 

iast 

iesb 

iparm 

ids 

Macro Call: 


Event flag to be set when the offspring task exits or emits 
status 

Name of an AST routine to be called when the offspring task 
exits or emits status 

Name of an 8-word status block to be written when the 
offspring task exits or emits status 

Word 0 — Offspring task exit status 

Word 1-7 — Reserved 

Name of a word to receive the status block address when an 
AST occurs 

Integer to receive the Directive Status Word 


SDRC$ 

tname 

buf 

efn 

east 

esb 


tname, buf, [efn], [east], [esb] 

= Target task name of the offspring task to be connected 

= Address of a 13-word send buffer 

= The event flag to be cleared on issuance and when the off¬ 
spring task exits or emits status 

= Address of an AST routine to be called when the offspring 
task exits or emits status 

= Address of an 8-word status block to be written when the 
offspring task exits or emits status 

Word 0 — Offspring task exit status 

Word 1-7 — Reserved 


Set Event Flag SETF$ 

FORTRAN Call: 

CALL SETEF (efn[,ids]) 


efn = Event flag number 

ids = Directive status 

Macro Call: 


SETF$ efn 


efn = Event flag number 
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Specify Floating Point Exception AST SFPA$ 

FORTRAN Call: 

Not supported 
Macro Call: 

SFPA$ [ast] 

ast = AST service routine entry point address 

Send Message SMSG$ 

FORTRAN Call: 

CALL SMSG (itgt,ibuf,ibufl,iprm,iprml,ids) 


itgt 

Integer containing the target object 

ibuf = 

Integer array containing the data to be inserted into the for¬ 
matted data packet 

ibufl = 

Integer containing length of the ibuf array 

iprm = 

Integer array containing any additional parameters 

iprml - 

Integer containing the number of parameters in the iprm 
array 

ids = 

Optional integer to receive the directive status 

Macro Call: 


SMSG$ tgt,buf,len,<pri,...,prn> 

tgt 

= Target identifier 

buf 

= Address of optional data buffer 

len 

= Length in bytes of optional data buffer 

pri.prn 

= Target-specific parameter list: 

Parameter list for Error Logging 

SMSG$ SM.SER,buf,len,typ,sub,lun,mask> 

typ 

= Error Log packet code 

sub 

= Error Log packet subtype code 

lun 

= Logical unit number of device 

msk 

= Control mask word 
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Specify Parity Error AST SPEA$ 

FORTRAN Call: 

Not supported 
Macro Call: 

SPEA$ [ast] 

ast = AST services routine entry point address 

Suspend ($S form recommended) SPNDSS 

FORTRAN Call: 

CALL SUSPND [(ids)] 
ids = Directive status 
Macro Call: 

SPND$S [err] 

err = Error routine address 

Specify Power Recovery AST SPRA$ 

FORTRAN Call: 

EXTERNAL sub 
CALL PWRUP (sub) 

sub = Name of a subroutine to be executed upon power recovery. The 
PWRUP subroutine will effect the following: 

CALL sub (no arguments) 

The subroutine is called as a result of a power recovery AST, 
and therefore the subroutine can be controlled at critical points 
by using the DSASTR (or INASTR) and ENASTR subroutine 
calls 

To Remove an AST: 

CALL PWRUP 
Macro Call: 

SPRA$ [ast] 

ast = AST service routine entry point address 
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Executive Directive Summary in Alphabetical Order by Macro Call 


Spawn 

FORTRAN Call: 
CALL SPAWN 

rtname = 

iugc 

iumc = 

iefn = 

iast = 

iesb = 


iparm = 

icmlin = 

icmlen = 

iunit = 

dnam = 

ids = 

Macro Call: 
SPWN tname,, 
tname = 

ugc = 

umc = 


SPWN$ 


(rtname, [iugc], [iumc], [iefn], [iast], [iesb], [iparm], [icmlin], 
[icmlen], [iunit], [dnam] [,ids]) 

Name (Radix-50) of the offspring task to be spawned 

Group code number for the UIC of the offspring task 

Member code number for the UIC of the offspring task 

Event flag to be set when the offspring task exits or emits 
status 

Name of an AST routine to be called when the offspring 
task exits or emits status 

Name of an 8-word status block to be written when the 
offspring task exits or emits status 

Word 0 — Offspring task exit status 

Word 1-7 — Reserved 

Name of a word to receive the status block address when the 
AST occurs 

Name of a command line to be queued for the offspring task 

Length of the command line (79. characters maximum) 

Unit number of terminal to be used as the TI: for the off¬ 
spring task (If the optional dnam parameter is not specified, 
this parameter must be the unit number of a virtual termi¬ 
nal created by the issuing task; if a value of 0 is specified, 
the TI: of the issuing task is propagated.) 

Device name mnemonic (If not specified, the virtual termi¬ 
nal is used as TI:.) 

Integer to receive the Directive Status Word 


[ugc], [umc], [efn], [east], [esb], [cmdlin], [cmdlen], [unum], [dnam] 
Name (Radix-50) of the offspring task to be spawned 
Group code number for the UIC of the offspring task 
Member code number for the UIC of the offspring task 
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Executive Directive Summary in Alphabetical Order by Macro Call 


efn 

east 

esb 

cmdlin 

cmdlen 

unum 

dnam 


The event flag to be cleared on issuance and set when the 
offspring task exits or emits status 

Address of an AST routine to be called when the offspring 
task exits or emits status 

Address of an 8-word status block to be written when the 
offspring task exits or emits status 

Word 0 — Offspring task exit status 

Word 1-7 — Reserved 

Address of a command line to be queued for the offspring 
task 

Length of the command line (maximum length is 79.) 

Unit number of terminal to be used as the TI: for the off¬ 
spring task (If the optional dnam parameter is not specified, 
this parameter must be the unit number of a virtual termi¬ 
nal created by the issuing task; if a value of 0 is specified, 
the TI: of the issuing task is propagated.) 

Device name mnemonic (If not specified, the virtual termi¬ 
nal is used as TI:.) 


NOTE 

1. If neither unum nor dnam is specified, the TI: of the 
issuing task is propagated. 

2. If only unum is specified, TI: is a virtual terminal. 


Specify Receive Data AST SRDA$ 

FORTRAN Call: 

Not available to FORTRAN 


Macro Call: 


SRDA$ [ast] 

ast = AST service routine entry point address 


Specify Requested Exit AST SREA$ 

SREXS 

FORTRAN Call: 

CALL SREA (ast[,idsl) 

ast = Name of the externally declared AST subroutine 
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Executive Directive Summary in Alphabetical Order by Macro Call 


ids = Name of an optional integer to receive the Directive Status 

Word 

CALL SREX (ast,ipblk,ipblkl,[dummy][,ids]) 


ast 

= Name of the externally declared AST subroutine 

ipblk 

= Name of an integer array to receive the trap-dependent 
parameters 

ipblkl 

dummy 

ids 

= Number of parameters to be returned into the ipblk array 

= Reserved for future use 

= Name of an optional integer to receive the Directive Status 
Word 

Macro Call: 



SREA$ [ast] 

SREX$ [ast][,dummy] 


ast 

= AST service routine entry point address 

dummy 

= Reserved for future expansion 


Send By Reference SREF$ 

FORTRAN Call: 

CALL SREF (tsk,[efn],iwdb,[isrb][,ids]) 
tsk = Receiver task name 


efn = 

Event flag number 

iwdb = 

An 8-word integer array containing a Window Definition Block 
(see Section 3.5.2.2) 

isrb = 

An 8-word integer array containing additional information 

ids = 

Directive status 

Macro Call: 



SREF$ task,wdb[,efn] 

task = Receiver task name 

wdb = Window Definition Block address 

efn = Event flag number 
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Executive Directive Summary in Alphabetical Order by Macro Call 


Specify Receive-By-Reference AST SRRA$ 

FORTRAN Call: 

Not supported 
Macro Call: 

SRRA$ fast] 

ast = AST service routine entry point address 

Set Affinity STAF$ 

FORTRAN Call: 

CALL STAF (iaff[,idsl) 

iaff = Affinity mask word 
ids = Integer to receive Directive Status Word 
Macro Call: 

STAF$ [cp!ub!ub...] 

cp = CPU selected (A through D) 

ub = UNIBUS run(s) selected (E through T) 

Set System Time Directive STIM$ 

FORTRAN Call: 

CALL SETTIM (ibufn[,ibufp][,idsl) 

ibufn = An 8-word integer array, new time specification buffer 

ibufp = An 8-word integer array, previous time buffer 

ids = Directive status 
Macro Call: 

STIM$ bufn,[bufp] 

bufn = Address of 8-word new time specification buffer 

bufp = Address of 8-word buffer to receive the previous system time 

parameters 
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Stop For Logical OR Of Event Flags STLO$ 

FORTRAN Call: 

CALL STLOR (iefl,ief2,ief3, ... ief(n)) 

iefl ... ief(n) = List of event flag numbers 
Macro Call: 

STLO$ grp, msk 

grp = Desired group of event flags 
msk = A 16-bit mask word 

Stop ($S form recommended) STOP$S 

FORTRAN Call: 

CALL STOP ([ids]) 

ids = Integer to receive the Directive Status Word 
Macro Call: 

STOP$S 

Stop For Single Event Flag STSE$ 

FORTRAN Call: 

CALL STOPFR (iefn[,idsl) 
iefn = Event flag number 
ids = Integer to receive Directive Status Word 
Macro Call: 

STSE$ efn 

efn = Event flag number 

Specify SST Vector Table For Debugging Aid SVDB$ 

FORTRAN Call: 

Not supported 
Macro Call: 

SVDB$ [adr][,len] 

adr = Address of SST vector table 

len = Length of (that is, number of entries in) table in words 
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Specify SST Vector Table For Task SVTK$ 

FORTRAN Call: 

Not supported 
Macro Call: 

SVTK$ [adr][,len] 

adr = Address of SST vector table 

len = Length of (that is, number of entries in) table in words 

Unlock Group Global Event Flags ($$ form recommended) ULGF$S 

FORTRAN Call: 

CALL ULGF ([ids]) 

ids = Directive status 
Macro Call: 

ULGF$S [err] 

err = Error routine address 

Unmap Address Window UNMAP$ 

FORTRAN Call: 

CALL UNMAP (iwdb[,idsj) 

iwdb = An 8-word integer array containing a Window Definition Block 
(see Section 3.5.2.2) 

ids = Directive status 

Macro Call: 

UMAP$ wdb 

wdb = Window Definition Block address 

Unstop TASK USTP$ 

FORTRAN Call: 

CALL USTP (rtname[,ids]) 

rtname = Name of task to be unstopped 

ids = Integer to receive directive status information 
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Macro Call: 

USTP$ tname 

tname = Name of task to be unstopped 

Wait For Significant Event ($S form recommended) WSIG$S 

FORTRAN Call: 

CALL WFSNE 
Macro Call: 

WSIG$S [err] 

err = Error routine address 

Wait For Logical OR Of Event Flags WTLO$ 

FORTRAN Call: 

CALL WFLOR (efnl,efn2,...efnn) 

efn = List of event flag numbers taken as the set of flags to be speci¬ 
fied in the directive 

Macro Call: 

WTLO$ grp.msk 

grp = Desired group of event flags 
msk = A 16-bit octal mask word 

Wait For Single Event Flag WTSE$ 

FORTRAN Call: 

CALL WAITFR (efn[,idsl) 
efn = Event flag number 
ids = Directive status 
Macro Call: 

WTSE$ efn 

efn = Event flag number 
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RADIX-50 CONVERSION TABLE 


To convert 1 to 3 characters to their Radix-50, 6-digit octal equivalent, add the 
appropriate octal codes from the following table, based on the positions (that is, 
first, second, or third) of the characters in the string. 



First 

Second 

Third 

Character 

Character 

Character 

Character 

Set 

Code 

Code 

Code 

Space 

000000 

000000 

000000 

A 

003100 

000050 

000001 

B 

006200 

000120 

000002 

C 

011300 

000170 

000003 

D 

014400 

000240 

000004 

E 

017500 

000310 

000005 

F 

022600 

000360 

000006 

G 

025700 

000430 

000007 

H 

031000 

000500 

000010 

1 

034100 

000550 

000011 

J 

037200 

000620 

000012 

K 

042300 

000670 

000013 

L 

045400 

000740 

000014 

M 

050500 

001010 

000015 

N 

053600 

001060 

000016 

0 

056700 

001130 

000017 

P 

062000 

001200 

000020 

Q 

065100 

001250 

000021 

R 

070200 

001320 

000022 

S 

073300 

001370 

000023 

T 

076400 

001440 

000024 

U 

101500 

001510 

000025 

V 

104600 

001560 

000026 

w 

107700 

001630 

000027 

X 

113000 

001700 

000030 

Y 

116100 

001750 

000031 

z 

121200 

002020 

000032 

$ 

124300 

002070 

000033 

. 

127400 

002140 

000034 

Unused 

132500 

002210 

000035 

0 

135600 

002260 

000036 

1 

140700 

002330 

000037 

2 

144000 

002400 

000040 
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RADIX-50 Conversion Table 


Character 

Set 

3 

4 

5 

6 

7 

8 
9 


First 

Character 

Code 

147100 

152200 

155300 

160400 

163500 

166600 

171700 


Second 

Character 

Code 

002450 

002520 

002570 

002640 

002710 

002760 

003030 


Third 

Character 

Code 

000041 

000042 

000043 

000044 

000045 

000046 

000047 
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OCTAL/DECIMAL CONVERSION TABLE 


Bits 

Octal 

Decimal 

15 

100000 

32768 


0 

0 


70000 

28672 


60000 

24576 

14 

50000 

20480 

13 

40000 

16384 

12 

30000 

12288 


20000 

8192 


10000 

4096 


0 

0 


7000 

3584 


6000 

3072 

11 

5000 

2560 

10 

4000 

2048 

9 

3000 

1536 


2000 

1024 


1000 

512 


0 

0 


700 

448 


600 

384 

8 

500 

328 

7 

400 

256 

6 

300 

192 


200 

128 


100 

64 


0 

0 


70 

56 


60 

48 

5 

50 

40 

4 

40 

32 

3 

30 

24 


20 

16 


10 

8 


0 

0 


7 

7 


6 

6 

2 

5 

5 

1 

4 

4 

0 

3 

3 


2 

2 


1 

1 


0 

0 


Octal to Decimal 

For each position of the octal value, 
locate the octal digit and its decimal 
equivalent in the conversion table. Add 
the decimal equivalents to obtain the 
decimal value. 


Example: 


53702(8) = ?(10) 
n(8) n(10) 

20480 
1536 
448 
00 
2 


50000 = 

3000 = 

700 = 

00 = 
2 = 


53702(8) = 22466(10) 


Decimal to Octal 

Locate in the conversion table the 
decimal value closest to, but not ex¬ 
ceeding, the decimal value to be con¬ 
verted. Record the octal equivalent. 
Subtract the table decimal value from 
the decimal value to be converted. 
Repeat the process until the subtrac¬ 
tion balance equals 0. Add the octal 
equivalents to obtain the octal value. 


Example: 


22466(10) = ?(8) 
n(10) = n(8) 


20480 

50000 

22466 
- 20480 

1536 

3000 

1986 

-1536 

448 

700 

450 

-448 

2 

2 

2 

-2 

22466(10) = 

53702(8) = 

0 
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STANDARD FILE TYPES 


RSX-11M uses the standard 3-letter file types used by all DIGITAL-supplied 
software. These names indicate the actual contents of the files. Although any 
combination of three letters can be used, DIGITAL recommends that the stan¬ 
dard types be used whenever possible. (Compilers and other system programs 
that refer to these file types look for the standard name as a default. For exam¬ 
ple, if the command FOR ADD = ADD is issued, the FORTRAN-IV compiler 
looks for ADD.FTN, and if the file is named ADD.FOR, the compiler reports 
that there is no such file.) 


Type 


File Contents 


.BAS 

.BAT 

.BLD 

.B2S 

CBL 

.CDA 

.CFS 

.CLB 

.CMD 

.CNF 

.COR 

.CRF 

.DAT 

.DIR 

.DMP 

.ERR 

-FTN 

.HLP 

.ICF 

.LOG 

.LST 

.MAC 

.MAP 

.MLB 

.OBJ 

ODL 

.OLB 

.PAT 

.PMD 


A BASIC-11 language source program 
Batch file (default) 

Indirect command files used as input to sysgen 

A BASIC-PLUS-II language source program 

A COBOL language source program 

Crash dump binary file 

Error Logging control file string 

Indirect Command Processor command library 

MCR or task commands (an indirect command file) 

An Error Logging language source file 
A SLP correction file 

Cross reference processor symbol table file 
File containing data (as opposed to a program) 

Directory File 

File Dump Utility output file 
Error Logger output file 

FORTRAN-IV or FORTRAN-IV PLUS language source file 
Help file 

An Error Logging intermediate form file output from 
Control File Language compiler 
Batch or console log file 
A listing file 

A MACRO-11 source program 
A Task Builder memory allocation map 
A macro library 

An object program (output from either the MACRO-11 
Assembler or a compiler) 

A Task Builder overlay descriptor 
An object module library 

Correction file used by assembler to create a patched 
object module 

Postmortem or snapshot dump file 
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Standard File Types 


Type 

.POB 

.SML 

.STB 

.SYM 

.SYS 

.TMP 

.TSK 

.TXT 

.ULB 


File Contents 

Patched object module used by the PAT utility 

The system macro library 

Symbol table file 

An Error Logging symbol file 

A bootable system image or other system file 

A temporary file 

A task image file 

A text file 

A universal file library 
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NOTES 


































